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(4-5. Objective-C 编程 艺术 》 GitBook 


Zen and the Art of the Objective-C Craftsmanship 中 文 翻 译 





https://github.com/oa414/objc-zen-book-cn/ 
Ig x https://github.com/objc-zen/objc-zen-book 
我 们 在 2013 年 11 月 份 开始 写 这 本 书 ， 最 初 的 目标 是 提供 一 份 编写 干净 漂亮 的 Objective-C 


代码 的 指南 : 现在 虽然 有 很 多 指南 ， 但 是 它们 都 是 有 一 些 问题 的 。 我 们 不 想 介绍 一 些 死板 的 规定 ， 我 们 想 提 供 一 个 在 开发 者 
们 之 间 写 更 一 致 的 代码 的 方法 。 随 时 间 的 推移 ， 这 本 书 开始 转向 介绍 如 何 设计 和 构建 优秀 的 代码 。 


这 本 书 的 理念 是 代码 不 仅 是 可 以 编译 的 ， 同 时 应 该 是 “有 效 " 的 。 好 的 代码 有 一 些 特性 : 简明 ， 自 我 解释 ， 优 秀 的 组 织 ， 和 良好 
的 文档 ， 良 好 的 命名 ， 优 秀 的 设计 以 及 经 得 起 时 间 的 考验 。 


这 本 书 的 理念 是 是 代码 的 清晰 性 优先 于 性 能 ， 同 时 提供 为 什么 这 么 做 的 原因 。 


虽然 所 有 的 代码 都 是 Objective-C 写 的 ， 但 是 一 些 主题 是 通用 的 并 且 独 立 于 编程 语言 的 。 


作者 


Luca Bernardi 


e http://lucabernardi.com 
e @luka bernardi 
e http://github.com/lukabernardi 


Alberto De Bortoli 


e http://albertodebortoli.com 
e (Qalbertodebo 
e http://github.com/albertodebortoli 
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关于 中 文 翻 译 
译 者 
林 翔 宇 


e http://linxiangyu.org 
e linxiangyu(nnupter.org 
e http://github.com/oa414 


庞 博 


e bopang@sohu-inc.com 
e https://github.com/heistings 


Kevin.Xiao 


e kevinxiao1919(2gmail.com 
e https:;//github.com/KevinHM 


翻译 已 得 到 原作 者 许可 ， 并 且 会 在 更 加 完善 后 申请 合并 到 原文 仓库 。 


GitBook 排版 


Yourtion 


e yourtion@gmail.com 
e https://github.com/yourtion 


根据 电子 书 做 了 部 分 章节 的 排版 优化 ， 支 持 Objective-C 语 法 高 之 。 如 有 修改 建议 优化 ， 请 直接 
Fork : https://github.comljyourtion/objc-zen-book-cnl 进行 修改 并 申请 Pull Request, 


z% 
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Preface 前 言 


我 们 在 2013 年 11 月 份 开 始 写 这 本 书 ， 最 初 的 目标 是 提供 一 份 如 何 编写 干净 漂亮 的 Objective-C 代码 的 指南 : 现在 虽然 有 很 
多 指南 ， 但 是 它们 都 是 有 一 些 问 题 的 。 我 们 不 想 介绍 一 些 死板 的 规定 ， 我 们 想 提供 一 个 在 开发 者 们 之 间 写 更 一 致 的 代码 的 途 
径 。 随 时 间 的 推移 ， 这 本 书 开始 转向 介绍 如 何 设计 和 构建 优秀 的 代码 。 


这 本 书 的 观点 是 代码 不 仅 是 可 以 编译 的 ， 同 时 应 该 是 “有 效 " 的。 好 的 代码 有 一 些 特性 : 简明 ， 自 我 解释 ， 优 秀 的 组 织 ， 良 好 
的 文档 ， 和 良好 的 命名 ， 优 秀 的 设计 以 及 可 以 被 久 经 考验 。 


本 书 的 一 个 理念 是 是 代码 的 清晰 性 优先 于 性 能 ， 同 时 阐述 为 什么 应 该 这 么 做 。 


虽然 所 有 的 代码 都 是 Objective-C 写 的 ， 但 是 一 些 主题 是 通用 的 ， 并 且 独 立 于 编程 语言 。 


a 
Dll 
Cn 
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Swift 


在 2014 年 6 月 6 日 ， 茶 果 发 布 了 面向 iOS 和 Mac 开发 的 新 语言 : Swift, 


这 个 新 语言 与 Objective-C 截然 不 同 。 所 以 ， 我 们 改变 了 写 这 本 书 的 计划 。 我 们 决定 发 布 这 本 书 当前 的 状态 ， 而 不 是 继续 书 
写 我 们 原来 计划 写 下 去 的 主题 。 


Objective-C 没有 消失 ， 但 是 现在 用 一 个 慢 慢 失去 关注 的 语言 来 继续 写 这 本 书 并 不 是 一 个 明智 的 选择 。 


Swift 


18. 5- Objective-C 编程 艺术 





贡献 给 社区 


我 们 将 这 本 书 免费 发 布 并 且 贡 献 给 社区 ， 因 为 我 们 希望 提供 给 读者 一 些 有 价值 的 内 容 。 如 果 你 能 学 到 至 少 一 条 最 佳 实践 ， 我 
们 的 目的 就 达到 了 。 





我 们 已 经 非常 用 心地 打磨 了 这 些 文字 ， 但 是 仍然 可 能 有 一 些 拼 写 或 者 其 他 错误 。 我 们 非常 希望 读者 给 我 们 一 个 反馈 或 者 建 
议 ， 以 来 改善 本 书 。 所 以 如 果 有 什么 问题 的 话 ， 请 联系 我 们 。 我 们 非常 欢迎 各 种 pull-request。 


贡献 给 社 





P4 
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作者 


Luca Bernardi 


e http://lucabernardi.com 
e @Iuka bernardi 
e http://github.com/lukabernardi 


Alberto De Bortoli 


e http://albertodebortoli.com 
e (Qalbertodebo 
e http://github.com/albertodebortoli 


作者 
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天 于 中 文 翻译 
译 者 
Ha 


e http://linxiangyu.org 
e linxiangyu(nnupter.org 
e http://github.com/oa414 


庞 博 


e bopang@sohu-inc.com 
e https://github.com/heistings 


Kevin.Xiao 


e kevinxiao1919(2gmail.com 
e https:;//github.com/KevinHM 


翻译 已 得 到 原作 者 许可 ， 并 且 会 在 更 加 完善 后 申请 合并 到 原文 仓库 。 


部 分 译文 表达 可 能 存在 不 受 之 处 ， 非 常 欢迎 各 种 修订 建议 和 校 了 从 。 请 直接 fork 本 仓库 ， 在 README.md 文件 中 修改 ， 并 申 
请 pull request 到 https://github.com/oa414/objc-zen-book-cn/. 


GitBook 排版 


Yourtion 


e yourtiongmail.com 
e https:;//github.com/yourtion 


根据 电子 书 做 了 部 分 章节 的 排版 优化 ， 支 持 Objective-C 语 法 高 之 。 如 有 修改 建议 优化 ， 请 直接 
Fork : https://github.comlyourtionlobjc-zen-book-cn/ 进行 修改 并 申请 Pull Request, 
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条 件 语句 


条 件 语句 体 应 该 总 是 被 大 括号 包围 。 尽 管 有 时 候 你 可 以 不 使 用 大 括号 〈 比 如 ， 条 件 语句 体 只 有 一 行内 容 ) ， 但 是 这 样 做 会 带 
来 问题 隐患 。 上 比如 ， 增 加 一 行 代码 时 ， 你 可 能 会 误 以 为 它 是 if 语 句 体 里 面 的 。 此 外 ， 更 危险 的 是 ， 如 果 把 if 后 面 的 那 行 代码 





注释 掉 ， 之 后 的 一 行 代 码 会 成 为 if 语句 里 的 代码 。 


推荐 : 


if (!error) { 
return success; 


} 


不 推荐 : 


if (!error) 
return success; 


和 


if (!error) return success; 


在 2014 年 2 月 葵 果 的 SSL/TLS 实现 里 面 发 现 了 知名 的 goto fail 错误 。 


代码 在 这 里 : 


static OSStatus 
SSLVerifySignedServerKeyExchange(SSLContext *ctx, bool isRsa, SSLBuffer signedParams, 
uint8 t *signature, Uinti6 signatureLen) 


1 
OSStatus err; 


if ((err = SsLHashsHA1.update(&hashCtx, &serverRandom)) !- 0) 
goto fail; 

if ((err = SsLHashSHA1.update(&hashCtx, &signedParams)) !- 0) 
goto fail; 
goto fail; 

if ((err = SsLHashsHA1.final(&hashCtx, &hashOut)) !- 0) 
goto fail; 


fail: 
SSLFreeBuffer(&signedHashes); 
SSLFreeBuffer(&hashCtx); 
return err; 


Hi 


显而易见 ， 这 里 有 没有 括号 包围 的 2 行 连续 的 goto fail; 。 我 们 当然 不 希望 写 出 上 面 的 代码 导致 错误 。 


此 外 ， 在 其 他 条 件 语句 里 面 也 应 该 按照 这 种 风格 统一 ， 这 样 更 便于 检查 。 


条 件 语句 
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不 要 使 用 尤 达 表达 式 。 尤 达 表 达 式 是 指 ， 拿 一 个 常量 去 和 变量 比较 而 不 是 拿 变 量 去 和 常量 比较 。 它 就 像 是 在 表达 “ 蓝 色 是 不 
是 天 空 的 颜色 "或 者 “高 个 是 不 是 这 个 男人 的 属性 ” 而 不 是 “天 空 是 不 是 蓝 的 " 或 者 “这 个 男人 是 不 是 高 个 子 的 ” 








( 译 者 注 : 名 字 起 源 于 星球 大 战 中 尤 达 大 病 的 讲话 方式 ， 总 是 用 倒 装 的 语序 ) 


推荐 : 


if ([myValue isEqual:Q42]) { ... 


不 推荐 : 


if ([@42 isEqual:myValue]) { ... 
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nil 和 BOOL 检查 
类 似 于 Yoda RAK, nil 检查 的 方式 也 是 存在 争议 的 。 一 些 notous 库 像 这 样 检 查 对 象 是 否 为 nil : 


if (nil == myValue) ( ... 


或 许 有 人 会 提出 这 是 错 的 ， 因 为 在 nil 作为 一 个 常量 的 情况 下 ， 这 样 做 就 像 Yoda 表达 式 了 。 但 是 一 些 程序 员 这 么 做 的 原因 
是 为 了 避免 调试 的 困难 ， 看 下 面 的 代码 : 


if (myValue == nil) ( ... 
如 果 程 序 员 敲 错 成 这 样 : 


if (myValue = nil) ( ... 


这 是 合法 的 语句 ， 但 是 即使 你 是 一 个 丰富 经 验 的 程序 员 ， 即 使 果 着 眼睛 瞧 上 好 多 通 也 很 难 调试 出 错误 。 但 是 如 果 把 nil 放 在 左 
边 ， 因 为 它 不 能 被 赋值 ， 所 以 就 不 会 发 生 这 样 的 错误 。 如 果 程 序 员 这 样 做 ， 他 /她 就 可 以 轻松 检查 出 可 能 的 原因 ， 比 一 通 表 检 


查 敲 下 的 代码 要 好 很 多 。 


为 了 避免 这 些 奇怪 的 问题 ， 可 以 用 感叹 号 来 作为 运算 符 。 因 为 nil 是 解释 到 NO， 所 以 没 必要 在 条 件 语句 里 面 把 它 和 其 他 值 
比较 。 同 时 ， 不 要 直接 把 它 和 ves 比较 ， 因 为 ves 的 定义 是 1， 而 Boon 是 8bit 的 ， 实 际 上 是 char 类 型 。 


nil 和 BOOL 检查 12 
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黄金 大 道 


在 使 用 条 件 语句 编程 时 ， 代 码 的 左边 距 应 该 是 一 条 “黄金 "或 者 "快乐 "的 大 道 。 也 就 是 说 ， 不 要 许 套 if 语句 。 使 用 多 个 return 
可 以 避免 增加 循环 的 复杂 度 ， 并 提高 代码 的 可 读 性 。 因 为 方法 的 重要 部 分 没有 嵌 套 在 分 支 里 面 ， 并 且 你 可 以 很 清楚 地 找到 相 
关 的 代码 。 


推荐 : 


- (void)someMethod { 
if (![someOther boolvalue]) { 


return; 
j 
//Do something important 
y 
不 推荐 : 


- (void)someMethod 4 
if ([someOther boolvalue]) 4 
//Do something important 
y 
B 


Bi 
e 
2 
[in 
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复杂 的 表达 式 


当 你 有 一 个 复杂 的 if 子 句 的 时 候 ， 你 应 该 把 它们 提取 出 来 赋 给 一 个 BOOL 变量 ， 这 样 可 以 让 逻辑 更 清楚 ， 而 且 让 每 个 子 句 的 
意义 体现 出 来 。 


BOOL nameContainsSwift = [sessionName containsString:@"Swift"]; 
BOOL isCurrentYear = [sessionDateCompontents year] -- 2014; 
BOOL isSwiftSession - nameContainsSwift && isCurrentYear; 


if (isSwiftSession) ( 
// Do something very cool 


Hi 
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三 元 运算 符 


三 元 运算 符 ? 应 该 只 用 在 它 能 让 代码 更 加 清楚 的 地 方 。 一 个 条 件 语句 的 所 有 的 变量 应 该 是 已 经 被 求 值 了 的 。 类 似 证 语句， 计 


算 多 个 条 件 子 句 通常 会 让 语句 更 加 难以 理解 。 或 者 可 以 把 它们 重 构 到 实例 变量 里 面 。 


推荐 : 


result =a>b?x:y; 


不 推荐 : 


result Za»b?x-zc2»d?c:d:y; 


当 三 元 运算 符 的 第 二 个 参数 (if 分 支 ) 返回 和 条 件 语 句 中 已 经 检查 的 对 象 一 样 的 对 象 的 时 候 ， 下 面 的 表达 方式 更 灵巧 : 


推荐 : 


result = object ? : [self createObject]; 


不 推荐 : 


result = object ? object : [self createObject]; 
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错误 处 理 
有 些 方 法 通通 过 参数 返回 error 的 引用 ， 使 用 这 样 的 方法 时 应 当 检 查 方法 的 返回 值 ， 而 非 error 的 引用 。 


推荐 : 


NSError *error = nil; 
if (![self trySomethingWithError:&error]) 4 
// Handle Error 


} 


此 外 ， 一 些 茶 果 的 API 在 成 功 的 情况 下 会 对 error 参数 (如 果 它 非 NULL). 写 入 垃圾 值 (garbage values) ， 所 以 如 果 检 查 
error 的 值 可 能 导致 错误 (BERR) 。 





错误 处 理 
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Case 语 句 


除非 编译 器 强制 要 求 ， 括 号 在 case 语句 里 面 是 不 必要 的 。 但 是 当 一 个 case 包含 了 多 行 语句 的 时 候 ， 需 要 加 上 括号 。 


switch (condition) { 
case 1; 
KA Eet 
break; 
case 2: { 
V cei 
// Multi-line example using braces 
break; 
J 
case 3: 
TA ee 
break; 
default: 
4/4 e 


break; 


有 时 候 可 以 使 用 fall-through 在 不 同 的 case 里 面 执行 同一 段 代 码 。 一 个 fall-through 是 指 移 除 case 语句 的 “break" 然后 让 下 


面 的 case 继续 执行 。 


switch (condition) { 

case T: 

case 2: 
// code executed for values 1 and 2 
break; 

default: 
A aran 
break; 


当 在 switch 语句 里 面 使 用 一 个 可 枚 举 的 变量 的 时 候 ， 


switch (menuType) { 

case ZOCEnumNone: 
FI oai 
break; 

case ZOCEnumValuel: 
JM maa 
break; 

case ZOCEnumValue2: 
A eek 
break; 


default 是 不 必要 的 。 比 如 : 


此 外 ， 为 了 避免 使 用 默认 的 case， 如 果 新 的 值 加 入 到 enum， 程 序 员 会 马上 收 到 一 个 warning 通知 


Enumeration value 'ZOCEnumValue3' not handled in switch. (MUEX8 'zocEnumValue3' 没有 被 switch 4438) 


枚 举 类 型 


当 使 用 enum 的 时 候 ， 建 议 使 用 新 的 固定 的 基础 类 型 定义 ， 因 它 有 更 强大 的 的 类 型 检查 和 代码 补 全 。 SDK 现在 有 一 个 宏 来 


鼓励 和 促进 使 用 固定 类 型 定义 - Ns ENUM() 


例子 : 


Casej& i] 


17 


#57 Objective-C 编程 艺术 





typedef NS ENUM(NSUInteger, ZOCMachineState) { 
ZOCMachineStateNone, 
ZOCcMachineStateIdle, 
ZocMachineStateRunning, 
ZocMachineStatePaused 


}; 


Case 语 句 
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尽 可 能 遵守 Apple 的 命名 约定 ， 尤 其 是 和 内 存 管理 规则 (NARC) 相关 的 地 方 。 





推荐 使 用 长 的 、 描 述 性 的 方法 和 变量 名 。 


推荐 : 


UIButton *settingsButton; 


不 推荐 : 


UIButton *setBut; 


2> 
m 
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Constants 常量 


常量 应 该 以 驼峰 法 命名 ， 并 以 相关 类 名 作为 前 级 。 


推荐 : 


static const NSTimeInterval ZOCSignInViewControllerFadeOutAnimationDuration = 0.4; 


不 推荐 : 
static const NSTimeInterval fadeOutTime = 0.4; 


推荐 使 用 常量 来 代替 字符 串 字面 值 和 数字 ， 这 样 能 够 方便 复 用 ， 而 且 可 以 快速 修改 而 不 需要 查找 和 蔡 换 。 常 量 应 该 用 static 
声明 为 静态 常量 ， 而 不 要 用 #define ， 除 非 它 明确 的 作为 一 个 宏 来 使 用 。 


推荐 : 


static NSString * const ZOCCacheControllerDidClearCacheNotification = Q"ZOCCacheControllerDidClearCacheNotification"; 
static const CGFloat ZOCImageThumbnailHeight = 50.0f; 


FT MM (1d 


不 推荐 : 


#define CompanyName Q"Apple Inc." 
4define magicNumber 42 


常量 应 该 在 头 文件 中 以 这 样 的 形式 暴露 给 外 部 : 
extern NSString *const ZOCCacheControllerDidClearCacheNotification; 


并 在 实现 文件 中 为 它 赋值 。 


只 有 公有 的 常量 才 需 要 添加 命名 空间 作为 前 级 。 尽 管 实现 文 件 中 私有 常量 的 命名 可 以 遵循 另外 一 种 模式 ， 你 仍旧 可 以 遵循 这 


个 规 则 o 
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方法 


方法 名 与 方法 类 型 ( - /+ 符号 ) 之 间 应 该 以 空格 间隔 。 方 法 段 之 间 也 应 该 以 空格 间隔 (以 符合 Apple RUE) 。 参 数 前 应 该 总 


是 有 一 个 描述 性 的 关键 词 。 


D 


忌 可 能 少 用 "and" ix 4i. "E E iARFHENDIBHAETSES, HS NEH initwithwidth:height: 这 个 例子 : 


推荐 : 


- (void)setExampleText:(NSString *)text image:(UIImage *)image; 

- (void)sendAction:(SEL)aSelector to:(id)anObject forAllCells:(B001)flag; 
- (id)viewwithTag:(NSInteger)tag; 

- (instancetype)initWithwWidth:(CGFloat)width height:(CGFloat)height; 


不 推荐 : 


- (void)setT:(NSString *)text i:(UIImage *)image; 

- (void)sendAction:(SEL)aSelector :(id)anObject :(5800L)flag; 

- (id)taggedView:(NSInteger)tag; 

- (instancetype)initWithwidth:(CGFloat)width andHeight:(CGFloat)height; 
- (instancetype)initWith:(int)width and:(int)height;  // Never do this. 


方法 
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字面 值 


使 用 字面 值 来 创建 不 可 变 的 Nsstring NsDictionary ，NSArray , Ml NsNumber 对 象 。 注 意 不 要 将 nil 传 进 NsArray 和 
NSDictionary 里 ， 因 为 这 样 会 导致 崩溃 。 


例子 : 


NSArray *names = Q[Q"Brian", Q"Matt", Q"Chris", Q"Alex", Q"Steve", Q"Paul"]; 

NSDictionary *productManagers = Q(Q"iPhone" : Q"Kate", Q"iPad" : Q"Kamal", Q"Mobile Web" : Q"Bill"); 
NSNumber *shouldUseLiterals = QYES; 

NSNumber *buildingZIPCode = (10018; 


不 要 这 样 : 


NSArray *names = [NSArray arrayWithObjects:Q"Brian", Q"Matt", Q"Chris", Q"Alex", Q"Steve", Q"Paul", nil]; 

NSDictionary *productManagers - [NSDictionary dictionaryWithObjectsAndKeys: Q"Kate", Q"iPhone", Q"Kamal", Q"iPad", Q"Bi 
NSNumber *shouldUseLiterals = [NSNumber numberWithBool:YES]; 

NSNumber *buildingZIPCode = [NSNumber numberwithInteger:10018]; 


[a = H 


如 果 要 用 到 这 些 类 的 可 变 副 本 ， 我 们 推荐 使 用 NsMutableArray , NSMutablestring 这 样 的 类 。 





应 该 避免 下 面 这 样 : 


NSMutableArray *aMutableArray = [@[] mutableCopy]; 


面 这 种 书写 方式 的 效率 和 可 读 性 的 都 存在 问题 。 


效率 方面 ， 一 个 不 必要 的 不 可 变 对 象 被 创建 后 立马 被 废弃 了 ; 虽然 这 并 不 会 让 你 的 App zig 〈 除 非 这 个 方法 被 频繁 调用 ) ， 
但 是 确实 没 必要 为 了 少 打 几 个 字 而 这 样 做 。 


可 读 性 方面 ， 存 在 两 个 问题 : 第 一 个 问题 是 当 你 浏览 代码 并 看 见 ep] 的 时 候 ， 你 首先 联想 到 的 是 NsArray 实例 ， 但 是 在 这 
种 情形 下 你 需要 停 下 来 深思 熟 虑 的 检查 ; 


另 一 个 问题 是 ， 一 些 新 手 以 他 的 水 平 看 到 你 的 代码 后 可 能 会 对 这 是 一 个 可 变 对 象 还 是 一 个 不 可 变 对 象 产生 分 歧 。 他 /她 可 能 
熟悉 可 变 拷 贝 构造 的 含义 (这 并 不 是 说 这 个 知识 不 重要 ) 。 


当然 ， 不 存在 绝对 的 错误 ， 我 们 只 是 讨论 代码 的 可 用 性 (包括 可 读 性 )。 
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M^ 
A 


3 


zK 
大 


类 名 应 该 以 三 个 大 写字 母 作 为 前 级 ( 双 字 母 前 级 为 Apple 的 类 预 留 ) 。 尽 管 这 个 规范 看 起 来 有 些 古 怪 ， 但 是 这 样 做 可 以 减少 
Objective-c 没有 命名 空间 所 带 来 的 问题 。 


一 些 开发 者 在 定义 模型 对 象 时 并 不 遵循 这 个 规范 (对 于 Core Data 对 象 ， 我 们 更 应 该 遵循 这 个 规范 ) 。 我 们 建议 在 定义 Core 
Data 对 象 时 严格 遵循 这 个 约定 ， 因 为 最 终 你 可 能 需要 把 你 的 Managed Object Model (托管 对 象 模型 ) 与 其 他 (第 三 方 库 ) 


的 MOMs (Managed Object Model) 合并 。 
你 可 能 注意 到 了 ， 这 本 书 里 类 的 前 级 (不 仅仅 是 类 ， 也 包括 公开 的 常量 、Protocol 等 的 前 级 ) 是 zoc 。 


另 一 个 好 的 类 的 命名 规范 : 当 你 创建 一 个 子 类 的 时 候 ， 你 应 该 把 说 明 性 的 部 分 放 在 前 级 和 父 类 名 的 在 中 间 。 


举 个 例子 : 如 果 你 有 一 个 zocNetworkclient 类 ， 子 类 的 名 字 会 是 zocTwitterNetworkclient (注意 "Twitter 在 "ZOC" 和 


"NetworkClient" 之 间 ); 按照 这 个 约定 ， 一 个 UIViewcontroller 的 子 类 会 是 zocTimelineViewController . 


» 
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Initializer 和 dealloc 初始 化 


推荐 的 代码 组 织 方式 是 将 dealloc 方法 放 在 实现 文件 的 最 前 面 (直接 在 Osynthesize 以 及 Gdynamic 之 后 ) ， init 应 该 跟 
在 dealloc 方法 后 面 。 如 果 有 多 个 初始 化 方法 ， 指定 初始 化 方法 (designated initializer 应 该 放 在 最 前 面 ， 间 接 初 始 化 方法 
(secondary initializer) RERE, 3X E SUBE dtl, 


如 今 有 了 ARC, dealoc 方法 几乎 不 需要 实现 ， 不 过 把 init 和 dealloc 放 在 一 起 可 以 从 视觉 上 强调 它们 是 一 对 的 。 通 常 ， 在 
init 方法 中 做 的 事情 需要 在 dealloc 方法 中 撤销 。 


init 方法 应 该 是 这 样 的 结构 : 


- (instancetype)init 
{ 
self = [super init]; // call the designated initialize 
if (self) ( 
// Custom initialization 
} 
return self; 
} 


为 什么 设置 self 为 [super init] 的 返回 值 ， 以 及 中 间 发 生 了 什么 呢 ? 这 是 一 个 十 分 有 趣 的 话题 。 


我 们 退 一 步 讲 : 我 们 常常 写 [[Nsobject alloc] init] 这 样 的 代码 ， 从 而 淡化 了 alloc 和 init 的 区 别 。Objective-C 的 这 个 
特性 叫做 两 步 创 建 。 这 意味 着 申请 分 配 内 存 和 初始 化 被 分 离 成 两 步 ， alloc 和 init. 


e alloc 负责 创建 对 象 ， 这 个 过 程 包括 分 配 足够 的 内 存 来 保存 对 象 ， 写 入 isa 指针 ， 初 始 化 引用 计数 ， 以 及 重 置 所 有 实 
例 变量 。 
e int 负责 初始 化 对 象 ， 这 意味 着 使 对 象 外 于 可 用 状态 。 这 通常 意味 着 为 对 象 的 实例 变量 赋予 合理 有 用 的 值 。 


alloc 方法 将 返回 一 个 有 效 的 未 初始 化 的 对 象 实例 。 每 一 个 对 这 个 实例 发 送 的 消息 会 被 转换 成 一 次 objc_msgsend() KIZI 
用 ， 形 参 self 的 实 参 是 alloc 返回 的 指针 ; 这 样 self 在 所 有 方法 的 作用 域内 都 能 够 被 访问 。 按照 惯例 ， 为 了 完成 两 步 创 
建 ， 新 创建 的 实例 第 一 个 被 调用 的 方法 将 是 init 方法 。 注 意 ， Nsobject 在 实现 init 时 ， 只 是 简单 的 返回 了 self 。 


关于 int 的 约定 还 有 一 个 重要 部 分 : 这 个 方法 可 以 (并 且 应 该 ) 通过 返回 nii 来 告诉 调用 者 ， 初 始 化 失败 了 ; 初始 化 可 能 
会 因为 各 种 原因 失败 ， 比 如 一 个 输入 的 格式 错误 了 ， 或 者 另 一 个 需要 的 对 象 初始 化 失败 了 。 这 样 我 们 就 能 理解 为 什么 总 是 需 
要 调用 self = [super init] 。 如 果 你 的 父 类 说 初始 化 自己 的 时 候 失败 了 ， 那 么 你 必须 假定 你 正 处 于 一 个 不 稳定 的 状态 ， 因 此 
在 你 的 实现 里 不 要 继续 你 自己 的 初始 化 并 且 也 返回 nil 。 如 果 不 这 样 做 ， 你 可 能 会 操作 一 个 不 可 用 的 对 象 ， 它 的 行为 是 不 可 
预测 的 ， 最 终 可 能 会 导致 你 的 程序 崩溃 。 


init 方法 在 被 调用 的 时 候 可 以 通过 重新 给 self 重新 赋值 来 返回 另 一 个 实例 ， 而 非 调用 的 那个 实例 。 例 如 关 铣 ， 还 有 一 些 
Cocoa 类 为 相等 的 (不 可 变 的 ) 对 象 返 回 同一 个 实例 。 


Designated 和 Secondary 初始 化 方法 


Objective-C 有 指定 初始 化 方法 (designated initializer) 和 间接 (secondary initializer) 初 始 化 方法 的 观念 。 designated 初始 化 方 
法 是 提供 所 有 的 参数 ，secondary 初始 化 方法 是 一 个 或 多 个 ， 并 且 提 供 一 个 或 者 更 多 的 默认 参数 来 调用 designated 初始 化 的 
初始 化 方法 。 


Qimplementation ZOCEvent 
- (instancetype)initWithTitle:(NSString *)title 
date:(NSDate *)date 


location:(CLLocation *)location 


self = [super init]; 
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LE (self £ 
_title = title; 
_date = date; 
.location = location; 
J 


return self; 


Hi 


- (instancetype)initWithTitle:(NSString *)title 
date:(NSDate *)date 
1 


return [self initWithTitle:title date:date location:nil]; 
Hi 
- (instancetype)initWithTitle:(NSString *)title 
1 
return [self initWithTitle:title date:[NSDate date] location:nil]; 
} 


Qend 


initWithTitle:date:location: 就 是 designated 初始 化 方法 ， 另 外 的 两 个 是 secondary 初始 化 方法 。 因 为 它们 仅仅 是 调用 类 
实现 的 designated 初始 化 方法 


Designated Initializer 


一 个 类 应 该 有 且 只 有 一 个 designated 初始 化 方法 ， 其 他 的 初始 化 方法 应 该 调用 这 个 designated 的 初始 化 方法 〈 虽 然 这 个 情 
况 有 一 个 例外 ) 


这 个 分 歧 没 有 要 求 那个 初始 化 函数 需要 被 调用 。 


在 类 继承 中 调用 任何 designated 初始 化 方法 都 是 合法 的 ， 而 且 应 该 保证 所 有 的 designated initializer 在 类 继承 中 是 从 祖先 
(通常 是 Nsobject ) 到 你 的 类 向 下 调用 的 。 


实际 上 这 意味 着 第 一 个 执行 的 初始 化 代码 是 最 远 的 祖先 ， 然 后 从 顶 向 下 的 类 继承 ， 所 有 类 都 有 机 会 执行 他 们 特定 初始 化 代 
码 。 这 样 ， 你 在 做 特定 初始 化 工作 前 ， 所 有 从 超 类 继承 的 东西 都 是 不 可 用 的 状态 。 虽然 这 没有 明确 的 规定 ， 但 是 所 有 Apple 
的 框架 都 保证 遵守 这 个 约定 ， 你 的 类 也 应 该 这 样 做 。 


当 定义 一 个 新 类 的 时 候 有 三 个 不 同 的 方式 : 





1. 不 需要 重 栽 任何 初始 化 函数 
2. 重 载 designated initializer 
3. 定义 一 个 新 的 designated initializer 


第 一 个 方案 是 最 简单 的 : 你 不 需要 增加 类 的 任何 初始 化 逻辑 ， 只 需要 依照 父 类 的 designated initializer, 


当 你 希望 提供 额外 的 初始 化 逮 辑 的 时 候 ， 你 可 以 重 载 designated initializer。 你 只 需要 重 载 直接 超 类 的 designated initializer 
并 且 确 认 你 的 实现 调用 了 超 类 的 方法 。 


一 个 典型 的 例子 是 你 创造 urviewcontroller 子 类 的 时 候 重 载 initwithNibName:bundle: 方法 。 


Qimplementation ZOCViewController 


- (id)initwithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil 


1 
// call to the superclass designated initializer 
self = [super initwithNibName:nibNameOrNil bundle:nibBundleOrNil]; 
if (self) ( 
// Custom initialization (〈 自 定义 的 初始 化 过 程 ) 
return self; 
J 
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Qend 


在 uiviewcontroller 子 类 的 例子 里 面 如 果 重 载 init 会 是 一 个 错误 ， 这 个 情况 下 调用 者 会 尝试 调用 initwithNib:bundle 初始 
化 你 的 类 ， 你 的 类 实现 不 会 被 调用 。 这 同样 违背 了 它 应 该 是 合法 调用 任何 designated initializer 的 规则 。 


在 你 希望 提供 你 自己 的 初始 化 函数 的 时 候 ， 你 应 该 遵守 这 三 个 步骤 来 保证 获得 正确 的 行为 : 
1. 定义 你 的 designated initializer， 确 保 调 用 了 直接 超 类 的 designated initializer, 
2. 重 载 直接 超 类 的 designated initializer。 调 用 你 的 新 的 designated initializer, 


3. 为 新 的 designated initializer 宇文 档 。 


很 多 开发 者 忽略 了 后 两 步 ， 这 不 仅仅 是 一 个 粗心 的 问 题 ， 而 且 这 违反 了 框架 的 规则 ， 能 导致 不 确定 的 行为 和 bug。 


让 我 们 看 看 正确 的 实现 的 例子 : 


Qimplementation ZOCNewsViewController 


- (id)initwithNews:(ZOCNews *)news 





// call to the immediate superclass's designated initializer (调用 EE 召 类 的 designated initializer) 
self = [super initwithNibName:nil bundle:nil]; 
if (self) ( 
.news - news; 
return self; 
// Override the immediate superclass's designated initializer (= designated initializer) 





- (id)initwithNibName:(NSString *)nibNameOrNil bundle:(NSBundle De 


{ 
// call the new designated initializer 
return [self initwithNews:nil]; 

y 

Qend 


如 果 你 没 重 载 initwithNibName:bundle: ， 而 且 调用 者 决定 用 这 个 方法 初始 化 你 的 类 (这 是 完全 合法 的 )。 initwithNews: 永远 
不 会 被 调用 ， 所 以 导致 了 不 正确 的 初始 化 流程 ， 你 的 类 的 特定 初始 化 逻辑 没有 被 执行 。 


即使 可 以 推断 那个 方法 是 designate initializer， 也 最 好 清晰 地 明确 它 (未 来 的 你 或 者 其 他 开发 者 在 改 代码 的 时 候 会 感谢 你 
By) 。 你 应 该 考虑 来 用 这 两 个 策略 (不 是 互 斥 的 ) : 第 一 个 是 你 在 文档 中 明确 哪 一 个 初始 化 方法 是 designated 的 ， 你 可 以 用 
编译 器 的 指令 attribute_((objc_designated_initializer)) 来 标记 你 的 意图 。 


用 这 个 编译 指令 的 时 候 ， 编 译 器 会 来 帮 你 。 如 果 你 的 新 的 designate initializer 没有 调用 超 类 的 designated initializer， 那 么 编 
会 发 出 警告 。 


然而 ， 当 没有 调用 类 的 designated initializer 的 时 候 〈 并 且 依 次 提供 必要 的 参数 ) ， 并 且 调 用 其 他 父 类 中 的 designated 
initialize 的 时 候 ， 会 变 成 一 个 不 可 用 的 状态 。 参 考 之 前 的 例子 ， 当 实例 化 一 个 zocNewsviewcontroller 展示 一 个 新 闻 而 那 条 新 
闻 没 有 展示 的 话 ， 就 会 毫 无 意义 。 这 个 情况 下 你 应 该 只 需要 让 其 他 的 designated initializer 失效 ， 来 强制 调用 一 个 非常 特别 的 
designated initializer。 通 过 使 用 另外 一 个 编译 器 指令 _ attribute ((unavailable("Invoke the designated initializer"))) 来 
修饰 一 个 方法 ， 通 过 这 个 属性 ， 会 让 你 在 试图 调用 这 个 方法 的 时 候 产生 一 个 编译 错误 。 


这 是 之 前 的 例子 相关 的 实现 的 头 文件 (这 里 使 用 宏 来 让 代码 没有 那么 哆 叶 ) 


Qinterface ZOCNewsViewController : UIViewController 


- (instancetype)initWithNews:(ZOCNews *)news ZOC DESIGNATED INITIALIZER; 


- (instancetype)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil ZOC UNAVAILABLE INSTEAD(init 
- (instancetype)init ZOC UNAVAILABLE INSTEAD(initWithNews:); 
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Qend 
本 


上 述 的 一 个 推论 是 : 你 应 该 永远 不 从 designated initializer 里 面 调用 一 个 secondary initializer (如 果 secondary initializer 遵 
守 约 定 ， 它 会 调用 designated initializer) 。 如 果 这 样 ， 调 用 很 可 能 会 调用 一 个 子 类 重 写 的 init 方法 并 且 陷 人 无 限 递归 之 中 。 























不 过 一 个 例外 是 一 个 对 象 是 否 遵守 NSCoding 协议 ， 并 且 它 通过 方法 initwithcoder: 初始 化 。 
我 们 应 该 看 超 类 是 否 符合 Nscoding 协议 来 区 别 对 待 。 


符合 的 时 候 ， 如 果 你 只 是 调用 [super initwithcoder:] ， 你 可 能 需要 在 designated initializer 里 面 写 一 些 通用 的 初始 化 代 
码 ， 处 理 这 种 情况 的 一 个 好 方法 是 把 这 些 代码 放 在 私有 方法 里 面 (比如 p_commonInit )。 


当 你 的 超 类 不 符合 Nscoding 协议 的 时 候 ， 推 荐 把 initwithcoder: 作为 secondary initializer 来 对 待 ， 并 且 调 用 self 的 
designated initializer。 注意 这 违反 了 Apple Et Archives and Serializations Programming Guide 上 面 的 规定 : 


the object should first invoke its superclass's designated initializer to initialize inherited state (对 象 总 是 应 该 首先 调用 
超 类 的 designated initializer 来 初始 化 继承 的 状态 ) 





如 果 你 的 类 不 是 Nsobject 的 直接 子 类 ， 这 样 做 的 话 ， 会 导致 不 可 预测 的 行为 。 
Secondary Initializer 


正如 之 前 的 描述 ，secondary initializer 是 一 种 提供 默认 值 、 行 为 到 designated initializer 的 方法 。 也 就 是 说 ， 在 这 样 的 方法 里 
面 你 不 应 该 有 初始 化 实例 变量 的 操作 ， 并 且 你 应 该 一 直 假 设 这 个 方法 不 会 得 到 调用 。 我 们 保证 的 是 唯一 被 调用 的 方法 是 


designated initializer。 


这 意味 着 你 的 secondary initializer 总 是 应 该 调用 Designated initializer 或 者 你 自 定义 (上 面 的 第 三 种 情况 : 自 定义 Designated 
initializer) 的 self 的 designated initializer。 有 时 候 ， 因 为 错误 ， 可 能 打 成 了 super ， 这 样 会 导致 不 符合 上 面 提 及 的 初始 化 顺 
Fe 〈 在 这 个 特别 的 例子 里 面 ， 是 跳 过 当前 类 的 初始 化 ) 


参考 


e https:;//developer.apple.com/library/ios/Documentation/General/Conceptual/DevPedia-CocoaCore/ObjectCreation.html 

e https:;//developer.apple.com/library/ios/documentation/General/Conceptual/CocoaEncyclopedia/lnitialization/Initializatio 
n.html 

e https:;//developer.apple.com/library/ios/Documentation/General/Conceptual/DevPedia- 
CocoaCore/Multiplelnitializers.html 

e https://blog.twitter.com/2014/how-to-objective-c-initializer-patterns 


instancetype 

我 们 经 常 忽 略 Cocoa 充满 了 约定 ， 并 且 这 些 约 定 可 以 帮助 编译 器 变 得 更 加 聪明 。 无 论 编译 器 是 否 遭 遇 alloc 或 者 init 77 
法 ， 他 会 知道 ， 即 使 返回 类 型 都 是 id ， 这 些 方法 总 是 返回 接受 到 的 类 类 型 的 实例 。 因 此 ， 它 允许 编译 器 进行 类 型 检查 。 
(比如 ， 检 查 方法 返回 的 类 型 是 否 合法 ) 。Clang 的 这 个 好 处 来 自 于 related result type, 意味 着 : 


messages sent to one of alloc and init methods will have the same static type as the instance of the receiver class 
(发 送 到 alloc 或 者 init 方法 的 消息 会 有 同样 的 静态 类 型 检查 是 否 为 接受 类 的 实例 。) 


更 多 的 关于 这 个 自动 定义 相关 返回 类 型 的 约定 请 查看 Clang Language Extensions guide 的 appropriate section) 


一 个 相关 的 返回 类 型 可 以 明确 地 规定 用 instancetype 关键 字 作 为 返回 类 型 ， 并 且 它 可 以 在 一 些 工厂 方法 或 者 构造 器 方法 的 场 
景 下 很 有 用 。 它 可 以 提示 编译 器 正确 地 检查 类 型 ， 并 且 更 加 重要 的 是 ， 这 同时 适用 于 它 的 子 类 。 
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Qinterface ZOCPerson 
+ (instancetype)personwithName:(NSString *)name; 
Qend 


虽然 如 此 ， 根 据 clang 的 定义 ， id 可 以 被 编译 器 提升 到 instancetype 。 在 alloc 或 者 init 中 ， 我 们 强烈 建议 对 所 有 返回 
类 的 实例 的 类 方法 和 实例 方法 使 用 instancetype 类 型 。 


在 你 的 API 中 要 构成 习惯 以 及 保持 始终 如 一 的 ， 此 外 ， 通 过 对 你 代码 的 小 调整 你 可 以 提高 可 读 性 : 在 简单 的 浏览 的 时 候 你 可 
以 区 分 哪些 方法 是 返回 你 类 的 实例 的 。 你 以 后 会 感谢 这 些 注 意 过 的 小 细节 的 。 


参考 


e http://tewha.net/2013/02/why-you-should-use-instancetype-instead-of-id/ 
e http://tewha.net/2013/01/when-is-id-promoted-to-instancetype/ 

e http://clang.llvm.org/docs/LanguageExtensions.html#related-result-types 
e http://nshipster.com/instancetype/ 


初始 化 模式 


#f (class cluster) 


类 铸 在 Apple 的 文档 中 这 样 描述 : 





an architecture that groups a number of private, concrete subclasses under a public, abstract superclass. (一 个 在 共 
有 的 抽象 超 类 下 设置 一 组 私有 子 类 的 架构 ) 




















如 果 这 个 描述 听 起 来 很 熟悉 ， 说 明 你 的 直觉 是 对 的 。 Class cluster 是 Apple 对 抽象 工厂 设计 模式 的 称呼 。 


class cluster 的 想法 很 简单 : 使 用 信息 进行 (类 的 ) 初 始 化 义理 期 间 ， 会 使 用 一 个 抽象 类 (通常 作为 初始 化 方法 的 参数 或 者 判定 
环境 的 可 用 性 参数 ) 来 完成 特定 的 逻辑 或 者 实例 化 一 个 具体 的 子 类 。 而 这 个 "Public Facing (面向 公众 的 ) "类 ， 必 须 非常 清 
楚 他 的 私有 子 类 ， 以 便 在 面 对 具体 任务 的 时 候 有 能 力 返 回 一 个 恰当 的 私有 子 类 实例 。 对 调用 者 来 说 只 需 知道 对 象 的 各 种 API 
的 作用 即 可 。 这 个 模式 隐藏 了 他 背后 复杂 的 初始 化 逻辑 ， 调 用 者 也 不 需要 关心 背后 的 实现 。 


Class clusters 在 Apple 的 Framework 中 广泛 使 用 : 一 些 明显 的 例子 比如 NsNumber 可 以 返回 不 同类 型 给 你 的 子 类 ， 取 决 于 
数字 类 型 如 何 提供 (Integer, Float, etc...) 或 者 NsArray 返回 不 同 的 最 优 存储 策略 的 子 类 。 


这 个 模式 的 精妙 的 地 方 在 于 ， 调 用 者 可 以 完全 不 管子 类 ， 事 实 上 ， 这 可 以 用 在 设计 一 个 库 ， 可 以 用 来 交换 实际 的 返回 的 类 ， 
而 不 用 去 管 相关 的 细节 ， 因 为 它们 都 遵从 抽象 超 类 的 方法 。 





我 们 的 经 验 是 使 用 类 簇 可 以 帮助 移 除 很 多 条 件 语句 。 
一 个 经 典 的 例子 是 如 果 你 有 为 iPad 和 iPhone 写 的 一 样 的 UlViewController 子 类 ， 但 是 在 不 同 的 设备 上 有 不 同 的 行为 。 


比较 基础 的 实现 是 用 条 件 语句 检查 设备 ， 然 后 执行 不 同 的 逻辑 。 哩 然 刚 开始 可 能 不 错 ， 但 是 随 着 代码 的 增长 ， 运 行 逻 辑 也 会 
趋 于 复杂 。 一 个 更 好 的 实现 的 设计 是 创建 一 个 抽象 而 且 宽 泛 的 view controller 来 包含 所 有 的 共享 远 辑 ， 并 且 对 于 不 同 设备 有 
两 个 特别 的 子 例 。 


通用 的 view controller 会 检查 当前 设备 并 且 返 回 适当 的 子 类 。 


@implementation ZOCKintsugiPhotoViewController 
- (id)initwithPhotos:(NSArray *)photos 
1 
if ([self isMemberOfClass:ZOCKintsugiPhotoViewController.class]) { 


self - nil; 


if ([UIDevice isPad]) { 
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self = [[ZOCKintsugiPhotoViewController iPad alloc] initwithPhotos :photos]; 


J 
else { 
self = [[ZOCKintsugiPhotoViewController iPhone alloc] initWithPhotos:photos]; 
ih 
return self; 
J 
return [super initwithNibName:nil bundle:nil]; 
ih 
@end 


个 子 例 程 展示 了 如 何 创建 一 个 类 得。 


1. 使 用 [self isMemberOfClass:ZOCKintsugiPhotoViewController.class] 防止 子 类 中 重 载 初始 化 方法 ， 避免 无 限 递 Ja 
W [[zocKintsugiPhotoViewController alloc] initwithPhotos:photos] 被 调用 时 ， 上 面条 件 表 达 式 的 结果 将 会 是 True。 


2. self = nil 的 目的 是 移 除 ZOCKintsugiPhotoViewController 实例 上 的 所 有 引用 ， 实例 (抽象 类 的 实例 ) 本 身 将 会 解除 分 配 ( 
当然 ARC 也 好 MRC 也 好 dealloc 都 会 发 生 在 Main Runloop 这 一 次 的 结束 时 ) 。 


3. 接 下 来 的 远 和 辑 就 是 判断 哪 一 个 私有 子 类 将 被 初始 化 。 我 们 假设 在 iPhone 上 运行 这 段 代 码 并 
H zocKintsugiPhotoviewController iPhone 没有 重 载 initwithPhotos: 方法 。 这 种 情况 下 ， 当 执行 self = 
[[ZocKintsugiPhotoViewController iPhone alloc] initwithPhotos:photos]; , ZoCKintsugiPhotoViewController 将 会 被 调用 ， 
第 一 次 检查 将 会 在 这 里 发 生 ， 鉴 于 zockintsugiphotoviewcontroller_iphone 不 完全 是 zocKintsugiPhotoViewcontroller ， 表 
达 式 [self isMemberOfClass:ZOCKintsugiPhotoViewController.class] 将 会 是 False, 于 是 就 会 调用 [super 
initwithNibName:nil bundle:nil], (sioe ÆJ zocKintsugiPhotoViewcontroller 的 初始 化 过 程 ， 这 时 候 因为 调用 者 就 
是 zockintsugiphotoviewcontroller 本 身 ， 这 一 次 的 检查 必定 为 True, 接 下 来 就 会 进行 正确 的 初始 化 过 程 。(NOTE : 这 里 必 
须 是 完全 遵循 Designated initializer HON initializer 的 设计 规范 的 前 提 下 才 会 其 效果 的 ! 不 明白 这 个 规范 的 可 以 
后 退 一 步 熟悉 这 种 规范 在 回头 来 看 这 个 说 明 ) 











NOTE: 这 里 的 意思 是 ， 代 码 是 在 iPhone 上 调试 的 ， 程 序 员 使 用 了 self = [[zockintsugiPhotoViewController_ipPhone 
alloc] initwithPhotos:photos]; 来 初始 化 某 个 view controller 的 对 象 ， 当 代码 运行 在 iPad 上 时 ， 这 个 初始 化 过 程 也 是 正 
确 的 ， 因 为 无 论 程序 员 的 代码 中 使 用 self = [[ZoCKintsugiPhotoViewController. iPhone alloc] 

initwithPhotos:photos]; 来 初始 化 viewController(iPhone 上 编写 运行 在 iPad 上 )， 还 是 使 用 self = 
[[ZoCKintsugiPhotoViewController iPad alloc] initwithPhotos:photos]; 来 初始 化 viewController(iPad 上 编写 ， 运行 在 
iPhone 上 )， 都 会 因为 ZOCKintsugiPhotoViewController 的 initwithPhotos: 方法 的 存在 而 变 得 通用 起 来 。 












































单 例 
如 果 可 能 ， 请 尽量 避免 使 用 单 例 而 是 依赖 注入 。 


然而 ， 如 果 一 定 要 用 ， 请 使 用 一 个 线程 安全 的 模式 来 创建 共享 的 实例 。 对 于 GCD， 用 dispatch once() PRAE n EAE, 


+ (instancetype)sharedInstance 
t 
static id sharedInstance - nil; 
static dispatch once t onceToken = 0; 
dispatch once(&onceToken, ^( 
sharedInstance - [[self alloc] init]; 
35 


return sharedInstance; 


使 用 dispatch_once()， 来 控制 代码 同步 ， 取 代 了 原来 的 约定 俗 成 的 用 法 。 


+ (instancetype)sharedInstance 


1 
static id sharedInstance; 
Gsynchronized(self) { 
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if (sharedInstance == nil) { 
sharedInstance - [[MyClass alloc] init]; 
} 
} 


return sharedInstance; 


dispatch once() 的 优点 是 ， 它 更 快 ， 而 且 语法 上 更 干净 ， 因 为 dispatch_once() 的 意思 就 是 “把 一 些 示 西 执行 一 次 "， 就 像 我 


们 做 的 一 样 。 这 样 同 时 可 以 避免 possible and sometimes prolific crashes. 

经 典 的 单 例 对 象 是 : 一 个 设备 的 GPS 以 及 它 的 加 速度 传感器 (也 称 动 作 感应 器 )。 

虽然 单 例 对 象 可 以 子 类 化 ， 但 这 种 方式 能 够 有 用 的 情况 非常 少见 。 

必须 有 证 据 表 明 ， 给 定 类 的 接口 趋向 于 作为 单 例 来 使 用 。 

所 以 ， 单 例 通常 公开 一 个 sharedInstance 的 类 方法 就 已 经 足够 了 ， 没 有 任何 的 可 写 属性 需要 被 暴露 出 来 。 


尝试 着 把 单 例 作 为 一 个 对 象 的 容器 ， 在 代码 或 者 应 用 层面 上 共享 ， 是 一 个 糟糕 和 天 陋 的 设计 。 





























NOTE : 单 例 模式 应 该 运用 于 类 及 类 的 接口 趋向 于 作为 单 例 来 使 用 的 情况 〈 译 者 注 ) 
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属性 


属性 应 该 尽 可 能 描述 性 地 命名 ， 避 免 缩 写 ， 并 且 是 小 写字 母 开 头 的 驼峰 命名 。 我 们 的 工具 可 以 很 方便 地 帮 有 我 们 自动 补 全 所 有 
示 西 C8. o LAMER, Xcode 的 Derived Data ARALI EME) 。 所 以 没 理由 少 打 几 个 字符 了 ， 并 且 最 好 尽 可 能 在 你 源 
码 里 表达 更 多 东西 。 





例子 : 


NSString *text; 


不 要 这 样 : 


NSString* text; 
NSString * text; 


(注意 : 这 个 习惯 和 常量 不 同 ， 这 是 主要 从 常用 和 可 读 性 考虑 。 C++ 的 开发 者 偏好 从 变量 名 中 分 离 类 型 ， 作 为 类 型 它 应 该 是 
NSstring* 《对 于 从 堆 中 分 配 的 对 象 ， 对 于 C++ 是 能 从 栈 上 分 配 的 ) 格式 。) 


使 用 属性 的 自动 同步 (synthesize) 而 不 是 手动 的 @synthesize 语句 ， 除 非 你 的 属性 是 protocol 的 一 部 分 而 不 是 一 个 完整 的 
类 。 如 果 Xcode 可 以 自动 同步 这 些 变量 ， 就 让 它 来 做 吧 。 否 则 只 会 让 你 抛 开 Xcode 的 优点 ， 维 护 更 元 长 的 代码 。 


你 应 该 总 是 使 用 setter 和 getter 方法 访问 属性 ， 除 了 init 和 dealloc 方法 。 通 常 ， 使 用 属性 让 你 增加 了 在 当前 作用 域 之 外 
的 代码 块 的 可 能 所 以 可 能 带 来 更 多 副作用 。 


你 总 应 该 用 getter 和 setter ， 因 为 : 





e 使 用 setter 会 遵守 定义 的 内 存 管 理 语义 ( strong, weak, copy etc..), ， 这 个 在 ARC 之 前 就 是 相关 的 内 容 。 举 个 例 
F, copy 属性 定义 了 每 个 时 候 你 用 setter 并 且 传 送 数 据 的 时 候 ， 它 会 复制 数据 而 不 用 额外 的 操作 。 

e KVO 通知 ( willchangevalueForkey ，didchangeValueForkey ) 会 被 自动 执行 。 

e 更 容易 debug : 你 可 以 设置 一 个 断 点 在 属性 声明 上 并 且 断 点 会 在 每 次 getter / setter 方法 调用 的 时 候 执行 ， 或 者 你 可 以 在 
自己 的 自 定义 setter/getter 设置 断 点 。 

e. 人 允许 在 一 个 单独 的 地 方 为 设置 值 添加 额外 的 运 辑 。 


你 应 该 倾向 于 用 getter : 


e 它 是 对 未 来 的 变化 有 扩展 能 力 的 (上 比如 ， 属 性 是 自动 生成 的 ) 。 

e. 它 人 允许 子 类 化 。 

e 更 简单 的 debug (比如 ， 人 允许 拿 出 一 个 断 点 在 getter 方法 里 面 ， 并 且 看 谁 访问 了 特别 的 getter 

e 它 让 意图 更 加 清晰 和 明确 : 通过 访问 ivar anrvar 你 可 以 明确 的 访问 self->_anIvar .这 可 能 导致 问题 。 在 block 里 面 访 
问 ivar (你 捕捉 并 且 retain T self， 即 使 你 没有 明确 的 看 到 self 关键 词 ) 。 

e 它 自动 产生 KVO 通知 。 

e 在 消息 发 送 的 时 候 增 加 的 开销 是 微不足道 的 。 更 多 关于 性 能 问题 的 介绍 你 可 以 看 Should | Use a Property or an Instance 
Variable?。 


Init 和 Dealloc 


有 一 个 例外 : 永远 不 要 在 init 方法 (以 及 其 他 初始 化 方法 ) 里 面 用 getter 和 setter 方法 ， 你 应 当 直 接 访问 实例 变量 。 这 样 做 
是 为 了 防止 有 子 类 时 ， 出 现 这 样 的 情况 : 它 的 子 类 最 终 重 载 了 其 setter 或 者 getter 方法 ， 因 此 导致 该 子 类 去 调用 其 他 的 方 
法 、 访 问 那 些 处 于 不 稳定 状态 ， 或 者 称 为 没有 初始 化 完成 的 属性 或 者 ivar 。 记 住 一 个 对 象 仅 仅 在 init 返回 的 时 候 ， 才 会 被 认 
为 是 达到 了 初始 化 完成 的 状态 。 
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同样 在 dealloc 方法 中 〈 在 dealloc 方法 中 ， 一 个 对 象 可 以 在 一 个 不 确定 的 状态 中 ) 这 是 同样 需要 被 注意 的 。 


e Advanced Memory Management Programming Guide under the self-explanatory section "Don't Use Accessor Methods 
in Initializer Methods and dealloc"; 

e Migrating to Modern Objective-C at WWDC 2012 at slide 27; 

e ina pull request form Dave DeLong's. 


此 外 ， 在 init 中 使 用 setter 不 会 很 好 执行 UrAppearence 代理 (参见 UlAppearance for Custom Views 看 更 多 相关 信息 )。 
点 符号 
当 使 用 setter getter 方法 的 时 候 尽 量 使 用 点 符号 。 应 该 总 是 用 点 符号 来 访问 以 及 设置 属性 。 


例子 : 


view.backgroundColor = [UIColor orangeColor]; 
[UIApplication sharedApplication].delegate; 


TEE 


[view setBackgroundColor:[UIColor orangeColor]]; 
UIApplication.sharedApplication.delegate; 


使 用 点 符号 会 让 表达 更 加 清晰 并 且 帮 助 区 分 属性 访问 和 方法 调用 
属性 定义 


推荐 按照 下 面 的 格式 来 定义 属性 


@property (nonatomic, readwrite, copy) NSString “name; 


属性 的 参数 应 该 按照 下 面 的 顺序 排列 : 原子 性 ， 读 写 和 内 存 管理 。 这 样 做 你 的 属性 更 容易 修改 正确 ， 并 且 更 好 阅读 。( 译 者 
注 : 习惯 上 修改 某 个 属性 的 修饰 符 时 ， 一 般 从 属性 名 从 右 向 左 搜索 需要 修 动 的 修饰 符 。 最 可 能 从 最 右边 开始 修改 这 些 属 性 的 
修饰 符 ， 根 据 经 验 这 些 修 饰 符 被 修改 的 可 能 性 从 高 到 底 应 为 : AFER > 读 写 权 限 > 原子 操作 ) 


你 必须 使 用 nonatomic ， 除 非特 别 需要 的 情况 。 在 iOS 中 ， atomic 带 来 的 锁 特 别 影响 性 能 。 


属性 可 以 存储 一 个 代码 块 。 为 了 让 它 存活 到 定义 的 块 的 结束 ， 必 须 使 用 copy (block 最 早 在 栈 里 面 创建 ， 使 用 copy 让 
block 拷贝 到 堆 里 面 去 ) 


为 了 完成 一 个 共有 的 getter 和 一 个 私有 的 setter， 你 应 该 声明 公开 的 属性 为 readoniy 并 且 在 类 扩展 总 重新 定义 通用 的 属性 
为 readwrite 的 。 


// .h 文 件 中 

Qinterface MyClass : NSObject 

Gproperty (nonatomic, readonly, strong) NSObject “object; 
Qend 
/ / .mx ttr 

Qinterface MyClass () 

Gproperty (nonatomic, readwrite, strong) NSObject “object; 
Qend 


Qimplementation MyClass 
//Do Something cool 
Qend 
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描述 ooL 属性 的 词 如 果 是 形容 词 ， 那 么 setter 不 应 该 带 is 前 级 ， 但 它 对 应 的 getter 访问 器 应 该 带 上 这 个 前 级 ， 如 : 


@property (assign, getter-isEditable) BOOL editable; 


文字 和 例子 引用 自 Cocoa Naming Guidelines, 
在 实现 文件 中 应 避免 使 用 esynthesize ,因为 Xcode 已 经 自动 为 你 添加 了 。 


私有 属性 


私有 属性 应 该 定义 在 类 的 实现 文件 的 类 的 扩展 (class extensions) 中 。 不 允许 在 有 名 字 的 的 category( 如 zocPrivate ) 中 定义 
私有 属性 ， 除 非 你 扩展 其 他 类 。 


例子 : 
Qinterface ZOCViewController () 
Gproperty (nonatomic, strong) UIView *bannerView; 
Qend 


DERE. 
任何 可 以 用 来 用 一 个 可 变 的 对 象 设 置 的 〈( 比 如 Nsstring , NSArray , NSURLRequest )) 属性 的 的 内 存 管理 类 型 必须 是 copy 的 。 


这 是 为 了 确保 防止 在 不 明确 的 情况 下 修改 被 封装 好 的 对 象 的 值 ( 译 者 注 : 比如 执行 array( 定 义 为 copy 的 NSArray 实例 ) = 
mutableArray, copy 属性 会 让 array 的 setter 方法 为 array = [mutableArray copy], [mutableArray copy] 返回 的 是 不 可 变 的 
NSArray 实例 ， 就 保证 了 正确 性 。 用 其 他 属性 修饰 符 修饰 ， 容 易 在 直接 赋值 的 时 候 ，array 指向 的 是 NSMuatbleArray 的 实 
例 ， 在 之 后 可 以 随意 改变 它 的 值 ， 就 容易 出 错 )。 


你 应 该 同时 避免 暴露 在 公开 的 接口 中 可 变 的 对 象 ， 因 为 这 允许 你 的 类 的 使 用 者 改变 类 自己 的 内 部 表示 并 且 破 坏 类 的 封装 。 你 
可 以 提供 可 以 只 读 的 属性 来 返回 你 对 象 的 不 可 变 的 副本 。 


AN 
@property (nonatomic, readonly) NSArray *elements 


fisse 4 
- (NSArray *)elements ( 
return [self.mutableElements copy]; 


Hi 


懒 加 载 (Lazy Loading) 


当 实例 化 一 个 对 象 需要 耗费 很 多 资源 ， 或 者 配置 一 次 就 要 调用 很 多 配置 相关 的 方法 而 你 又 不 想 弄 乱 这 些 方 法 时 ， 我 们 需要 重 
写 getter 方法 以 延迟 实例 化 ， 而 不 是 在 init 方法 里 给 对 象 分 配 内 存 。 通 常 这 种 操作 使 用 下 面 这 样 的 模板 : 


- (NSDateFormatter *)dateFormatter { 
if (!_dateFormatter) { 
_dateFormatter = [[NSDateFormatter alloc] init]; 
NSLocale *enUSPOSIXLocale = [[NSLocale alloc] initWithLocaleIdentifier:Q"en US POSIX"]; 
[.dateFormatter setLocale:enUSPOSIXLocale]; 
[ dateFormatter setDateFormat:Q"yyyy-MM-dd'T'HH:mm:ss.SSS"];//3zEW»zESSS, M3ESSSSS 
j 


return dateFormatter; 
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即使 这 样 做 在 某 些 情况 下 很 不 错 ， 但 是 在 实际 这 祥 做 之 前 应 当 深 思 熟 虑 。 事 实 上 ， 这 样 的 做 法 是 可 以 避免 的 。 下 面 是 使 用 延 


迟 实例 化 的 争议 。 


e getter 方法 应 该 避免 副作用 。 看 到 getter 方法 的 时 候 ， 你 不 会 想到 会 因此 创建 一 个 对 象 或 导致 副作用 ， 实 际 上 如 果 调 用 


getter 方法 而 不 使 用 其 返回 值 编译 器 会 报警 告 “Getter 不 应 该 仅 因 它 产生 的 副作用 而 被 调用 "。 


















































c 
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函数 外 的 变 























=) 或 修改 参数 。 画 数 副作用 会 给 程序 设计 带 来 不 必要 的 麻烦 ， 给 程序 带 来 十 分 难以 查找 的 错误 ， 
读 性 。 〈 译 者 注 ) 

















e 你 在 第 一 次 访问 的 时 候 改 变 了 初始 化 的 消耗 ， 产 生 了 副作用 ， 这 会 让 优化 性 能 变 得 困难 (以 及 测试 ) 











降低 程序 的 可 


e 这 个 初始 化 可 能 是 不 确定 的 : 比如 你 期 望 属 性 第 一 次 被 一 个 方法 访问 ， 但 是 你 改变 了 类 的 实现 ， 访 问 器 在 你 预期 之 前 就 
得 到 了 调用 ， 这 样 可 以 导致 问题 ， 特 别 是 初始 化 逻辑 可 能 依赖 于 类 的 其 他 不 同 状态 的 时 候 。 总 的 来 说 最 好 明确 依赖 关 


7l*o 


e 这 个 行为 不 是 KVO 友好 的 。 如 果 getter 改变 了 引用 ， 他 应 该 通过 一 个 KVO 通知 来 通知 改变 。 当 访问 getter 的 时 候 收 到 


一 个 改变 的 通知 很 奇怪 。 
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你 的 方法 可 能 要 求 一 些 参数 来 满足 特定 的 条 件 (比如 不 能 为 nil) ， 在 这 种 情况 下 啊 最 好 使 用 NspParameterAssert() 来 断 
件 是 否 成 立 或 是 抛 出 一 个 异常 。 


私有 方法 


永远 不 要 在 你 的 私有 方法 前 加 上 _ 前 级 。 这 个 前 级 是 Apple 保留 的 。 不 要 冒 重 载 荃 果 的 私有 方法 的 险 。 





方法 


E 


条 
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相等 性 


当 你 要 实现 相等 性 的 时 候 记 住 这 个 约定 : 你 需要 同时 实现 isEqual 和 hash 方法 。 如 果 两 个 对 象 是 被 isEqual 认为 相等 的 ， 它 


们 的 hash 方法 需要 返回 一 样 的 值 。 但 是 如 果 nash 返回 一 样 的 值 ， 并 不 能 确保 他 们 相等 。 


这 个 约定 是 因为 当 被 存储 在 集合 (如 Nspictionary 和 wsset 在 底层 使 用 hash 表 数 据 的 数据 结构 ) 的 时 候 ， 如 何 查找 这 


对 象 。 


Qimplementation ZOCPerson 


- (BOOL)isEqual:(id)object { 
if (self -- object) ( 
return YES; 
J 


if (![object isKindoOfClass:[ZOCPerson class]]) { 
return NO; 


} 


// check objects properties (name and birthday) for equality (检查 对 象 属性 





return propertiesMatch; 


Hi 


- (NSUInteger)hash { 
return [self.name hash] ^ [self.birthday hash]; 
Hi 


@end 


(名 字 和 生日 ) 的 相等 性 


b 


一 定 要 注意 hash 方法 不 能 返回 一 个 常量 。 这 是 一 个 典型 的 错误 并 且 会 导致 严重 的 问题 ， 因 为 实际 上 hash 方法 的 返回 值 会 作 


为 对 象 在 hash 散 列 表 中 的 key, 这 会 导致 hash 表 10096 的 碰撞 。 


你 总 是 应 该 用 isEqualTo<#class-name-without-prefix#>: 这 样 的 格式 实现 一 个 相等 性 检查 方法 。 如 果 你 这 样 做 ， 会 优先 调用 


这 个 方法 来 避免 上 面 的 类 型 检查 。 


一 个 完整 的 isEqual 方法 应 该 是 这 样 的 : 


- (BOOL)isEqual:(id)object { 
if (self == object) { 
return YES; 
J 


if (![object isKindoOfClass:[ZOCPerson class]]) { 
return NO; 


} 


return [self isEqualToPerson:(ZOCPerson *)object]; 


Hi 


- (BOOL)isEqualToPerson:(Person *)person ( 

if (!person) { 

return NO; 
J 
BOOL namesMatch - (!self.name && !person.name) || 

[self.name isEqualToString:person.name]; 
BOOL birthdaysMatch - (!self.birthday && !person.birthday) || 
[self.birthday isEqualToDate:person.birthday]; 


return haveEqualNames && haveEqualBirthdays; 


相等 性 
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一 个 对 象 实例 的 hash 计算 结果 应 该 是 确定 的 。 当 它 被 加 入 到 一 个 容器 对 象 (比如 wsarray , Nsset , 或 者 Nspictionary ) 的 
时 候 这 是 很 重要 的 ， 否 则 行为 会 无 法 预测 (所 有 的 容器 对 象 使 用 对 象 的 hash 来 查找 或 者 实施 特别 的 行为 ， 如 确定 唯一 性 ) 
这 也 就 是 说 ， 应 该 用 不 可 变 的 属性 来 计算 hash 值 ， 或 者 ， 最 好 保证 对 象 是 不 可 变 的 。 
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Categories 


虽然 我 们 知道 这 样 写 很 天 , 但 是 我 们 应 该 要 在 我 们 的 category 方法 前 加 上 自己 的 小 写 前 级 以 及 下 划 线 ， 上 比如 - 
(id)zoc myCategoryMethod o 这 种 实践 同样 被 苹果 推荐 。 


这 是 非常 必要 的 。 因 为 如 果 在 扩展 的 category 或 者 其 他 category 里 面 已 经 使 用 了 同样 的 方法 名 ， 会 导致 不 可 预计 的 后 果 。 
实际 上 ， 实 际 被 调用 的 是 最 后 被 加 载 的 那个 category 中 方法 的 实现 ( 译 者 注 : 如 果 导 入 的 多 个 category 中 有 一 些 同名 的 方法 
导 和 到 类 里 时 ， 最 终 调 用 哪个 是 由 编译 时 的 加 载 顺序 来 决定 的 ， 最 后 一 个 加 载 进来 的 方法 会 覆盖 之 前 的 方法 )。 


如 果 想 要 确认 你 的 分 类 方法 没有 覆盖 其 他 实现 的 话 ， 可 以 把 环境 变量 OBJC PRINT REPLACED METHODS 设置 为 YES， 
这 样 那些 被 取代 的 方法 名 字 会 打印 到 Console 中 。 现 在 LLVM 5.1 不 会 为 此 发 出 任何 警告 和 错误 提示 ， 所 以 自己 小 心 不 要 在 
分 类 中 重 载 方法 。 

一 个 好 的 实践 是 在 category 名 中 使 用 前 级 。 


例子 


Qinterface NSDate (ZOCTimeExtensions) 
- (NSString *)zoc timeAgoShort; 
Qend 


TER 


@interface NSDate (ZOCTimeExtensions) 
- (NSString *)timeAgoShort; 
@end 


分 类 可 以 用 来 在 头 文件 中 定义 一 组 功能 相似 的 方法 。 这 是 在 Apple 的 Framework 也 很 常见 的 一 个 实践 〈 下 面 例子 的 取 
自 Nspate 头 文件 ) 。 我 们 也 强烈 建议 在 自己 的 代码 中 这 样 使 用 。 


我 们 的 经 验 是 ， 创 建 一 组 分 类 对 以 后 的 重 构 十 分 有 帮助 。 一 个 类 的 接口 增加 的 时 候 ， 可 能 意味 着 你 的 类 做 了 太 多 事情 ， 
了 类 的 单一 功能 原则 。 


g 
lig 


之 前 创造 的 方法 分 组 可 以 用 来 更 好 地 进行 不 同 功 能 的 表示 ， 并 且 把 类 打破 在 更 多 自我 包含 的 组 成 部 分 里 。 


Qinterface NSDate : NSObject «NSCopying, NSSecureCoding» 

Qproperty (readonly) NSTimeInterval timeIntervalSinceReferenceDate; 
Qend 

Qinterface NSDate (NSDateCreation) 


* (instancetype)date; 

+ (instancetype)dateWithTimeIntervalSinceNow:(NSTimeInterval)secs; 

+ (instancetype)dateWithTimeIntervalSinceReferenceDate:(NSTimeinterval)ti; 

+ (instancetype)dateWithTimeIntervalSince1970:(NSTimeInterval)secs; 

+ (instancetype)dateWithTimeInterval:(NSTimeInterval)secsToBeAdded sinceDate:(NSDate *)date; 
Y JJ ARR se 


Qend 
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Protocols 


在 Objective-C 的 世界 里 面 经 常 错过 的 一 个 东西 是 抽象 接口 。 接 口 (interface) 这 个 词 通常 指 一 个 类 的 .n 文件 ， 但 是 它 在 
Java 程序 员 眼 里 有 另外 的 含义 : 一 系列 不 依赖 具体 实现 的 方法 的 定义 。( 译 者 注 : 在 Objective-C 中 ， 类 的 接口 对 应 在 .m 文 
件 中 都 会 有 具体 的 实现 ， 但 Java 中 接口 更 接近 于 Objective-C 中 的 抽象 接口 , 或 者 说 是 协议 (protocol)) 


在 Objective-C 里 是 通过 protocol 来 实现 抽象 接口 的 。 因 为 历史 原因 ，protocol (使 用 方法 类 似 Java 的 接口 ) 
在 Objective-C 的 代码 中 使 用 也 没有 在 社区 中 普及 ( 指 的 是 那 种 像 Java 程序 员 使 用 接口 那样 来 使 用 protocol 的 方式 )。 

要 原因 是 大 多 数 的 Apple 开发 的 代码 没有 采用 这 种 的 方式 ， 而 几乎 所 有 的 开发 者 都 是 遵从 Apple 的 模式 以 及 指南 。 PIN 5 
乎 只 是 在 委托 模式 下 使 用 protocol 


但 是 抽象 接口 的 概念 很 强大 ， 在 计算 机 科学 的 历史 中 颇 有 渊源 ， 没 有 理由 不 在 Objective-C 中 使 用 。 


这 里 通过 一 个 具体 的 例子 来 解释 protocol 的 强大 力量 (用 作 抽 象 接口 ) : 把 非常 糟糕 的 设计 的 架构 改造 为 一 个 良好 的 可 复 用 
的 代码 。 


这 个 例子 是 在 实现 一 个 RSS 阅读 器 〈 它 可 是 经 常 在 技术 面试 中 作为 一 个 测试 题 呢 ) 。 
要 求 很 简单 : 在 TableView 中 展示 一 个 远程 的 RSS 订阅 。 


一 个 幼稚 的 方法 是 创建 一 个 UITableviewcontroller 的 子 类 ， 并 且 把 所 有 的 检索 订阅 数据 ， kijai E 
或 者 说 是 一 个 MVC (Massive View Controller)。 这 可 以 跑 起 来 ， 但 是 它 的 设计 非常 糟糕 ， 不 过 它 足 够 过 一 些 要 求 不 高 的 面试 
Tes 


最 小 的 步骤 是 遵从 单一 功能 原则 ， 创 建 至 少 两 个 组 成 部 分 来 完成 这 个 任务 : 


e 一 个 feed 解析 器 来 解析 搜集 到 的 结果 
e 一 个 feed 阅读 器 来 显示 结果 


这 些 类 的 接口 可 以 是 这 样 的 : 


Qinterface ZOCFeedParser : NSObject 


Gproperty (nonatomic, weak) id «ZOCFeedParserDelegate» delegate; 
Gproperty (nonatomic, strong) NSURL “url; 


- (id)initWithURL:(NSURL *)url; 


- (BOOL)start; 
- (void)stop; 


Qend 


Qinterface ZOCTableViewController : UITableViewControlle 
- (instancetype)initWithFeedParser:(ZOCFeedParser *)feedParser; 


Qend 


ZocFeedParser 用 NSURL 进行 初始 化 ， 来 获取 RSS 订阅 (在 这 之 下 可 能 会 使 用 NSXMLParser fll NSXMLParserDelegate 
创建 有 意义 的 数据 ) ， zocTableviewcontroller 会 用 这 个 parser 来 进行 初始 化 。 我 们 希望 它 显 示 parser 接受 到 的 值 并 且 我 
们 用 下 面 的 protocol 实现 委托 : 
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Qprotocol ZOCFeedParserDelegate «NSObject» 

Qoptional 

- (void)feedParserDidStart:(ZOCFeedParser *)parser; 

- (void)feedParser:(ZOCFeedParser *)parser didParseFeedInfo:(ZOCFeedInfoDTO *)info; 
- (void)feedParser:(ZOCFeedParser *)parser didParseFeedItem:(ZOCFeedItemDTO *)item; 
- (void)feedParserDidFinish:(ZOCFeedParser *)parser; 

- (void)feedParser:(ZOCFeedParser *)parser didFailWithError:(NSError *)error; 

Qend 


我 要 说 ， 这 是 一 个 处 理 RSS 业务 的 完全 合理 而 恰当 的 protocol, ix^" view controller f£ public 接口 中 将 遵循 这 个 protocol : 


@interface ZOCTableViewController : UITableViewController <Z0CFeedParserDelegate> 


最 后 创建 的 代码 是 这 样子 的 : 


NSURL *feedURL = [NSURL URLWithString:Q"http://bbc.co.uk/feed.rss"]; 
ZOCFeedParser *feedParser = [[ZOCFeedParser alloc] initWithURL:feedURL]; 


ZOCTableViewController *tableViewController - [[ZOCTableViewController alloc] initWithFeedParser:feedParser]; 
feedParser.delegate - tableViewController; 


到 目前 你 可 能 觉得 你 的 代码 还 是 不 错 的 ， 但 是 有 多 少 代 码 是 可 以 有 效 复 用 的 呢 ? view controller 只 能 处 理 zocreedParser 类 
型 的 对 象 : 从 这 点 来 看 我 们 只 是 把 代码 分 离 成 了 两 个 组 成 部 分 ， 而 没有 做 任何 其 他 有 价值 的 事情 。 


view controller 的 职责 应 该 是 “显示 某 些 东 西 提供 的 内 容 "， 但 是 如 果 我 们 只 人 允许 传递 zocFeedParser 的 话 ， 就 不 是 这 样 的 了 。 
这 就 体现 了 需要 传递 给 view controller 一 个 更 泛 型 的 对 象 的 需求 。 


我 们 使 用 zocFeedparserProtocol 这 个 protocol (在 ZOCFeedParserProtocol.h 文件 里 面 ， 同 时 文件 里 也 有 


Z0CFeedParserDelegate )。 


@protocol ZOCFeedParserProtocol «NSObject» 


Gproperty (nonatomic, weak) id «ZOCFeedParserDelegate» delegate; 
Gproperty (nonatomic, strong) NSURL “url; 


- (BOOL)start; 

- (void)stop; 

Qend 

Qprotocol ZOCFeedParserDelegate «NSObject» 

Qoptional 

- (void)feedParserDidStart:(id«ZOCFeedParserProtocol»)parser; 

- (void)feedParser:(id«ZOCFeedParserProtocol»)parser didParseFeedInfo:(ZOCFeedInfoDTO *)info; 
- (void)feedParser:(id«ZOCFeedParserProtocol»)parser didParseFeedItem:(ZOCFeedItemDTO *)item; 
- (void)feedParserDidFinish:(id«ZOCFeedParserProtocol»)parser; 


- (void)feedParser:(id«ZOCFeedParserProtocol»)parser didFailWithError:(NSError *)error; 
Qend 


注意 这 个 代理 protocol 现在 处 理 响应 我 们 新 的 protocol, 而 且 ZOCFeedParser 的 接口 文件 更 加 精炼 了 : 


Qinterface ZOCFeedParser : NSObject «ZOCFeedParserProtocol» 
- (id)initWithURL:(NSURL *)url; 


Qend 
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因为 zoCFeedParser 实现 了 zocFeedParserprotocol ， 它 需要 实现 所 有 的 required 方法 。 


从 这 点 来 看 view controller 能 接受 任何 遵循 该 协议 的 对 象 ， 只 要 确保 所 有 的 对 象 都 会 响应 start 和 stop 方法 并 通 
过 delegate 属性 提供 信息 ( 译 者 注 : 因为 protocol 默认 情况 下 所 有 的 方法 定义 都 是 required 的 )。 对 指定 的 对 象 而 言 ， 这 就 是 
view controller 所 要 知道 的 一 切 , 且 不 需要 知道 其 实现 的 细节 。 


Qinterface ZOCTableViewController : UITableViewController «ZOCFeedParserDelegate» 


- (instancetype)initWithFeedParser:(id«ZOCFeedParserProtocol»)feedParser; 


Qend 


上 面 的 代码 片段 的 改变 看 起 来 不 多 ， 但 是 有 了 一 个 巨大 的 提升 。view controller FEET Viu ERR SE SUSET MR, ug 
来 了 以 下 的 优点 : 


e view controller 现在 可 以 接收 通过 delegate 属性 提供 信息 的 任意 对 象 : 可 以 是 RSS 远程 解析 器 ， 或 者 本 地 解析 器 ， 或 是 
一 个 读 取 其 他 远程 或 者 本 地 数据 的 服务 

e ZoCFeedParser 和 ZOCFeedParserDelegate 可 以 被 其 他 组 成 部 分 复 用 

e zocViewcontroller (Ul 逻辑 部 分 ) 可 以 被 复 用 

e 测试 更 简单 了 ， 因 为 可 以 用 mock 对 象 来 达到 protocol 预期 的 效果 


当 实 现 一 个 protocol 你 总 应 该 坚持 里 氏 蔡 换 原 则 。 这 个 原则 是 : 你 应 该 可 以 取代 任意 接口 〈 也 就 是 Objective-C 里 的 
的 "protocol") 实现 ， 而 不 用 改变 客户 端 或 者 相关 实现 。 


此 外 ， 这 也 意味 着 protocol 不 该 关心 类 的 实现 细节 ; 设计 protocol 的 抽象 表述 时 应 非常 用 心 ， 并 且 要 牢记 它 和 它 背 后 的 实现 
是 不 相干 的 ， 真 正 重要 的 是 协议 (这 个 暴露 给 使 用 者 的 抽象 表述 ) 。 


任何 在 未 来 可 复 用 的 设计 ， 无 形 当中 可 以 提高 代码 质量 ， 这 也 应 该 一 直 是 程序 员 的 追求 。 是 否 这 样 设计 代码 ， 就 是 大 病 和 菜 
B BSEC. 


最 后 的 代码 可 以 在 这 里 找到 。 
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NSNotification 


当 你 定义 你 自己 的 wsNotification 的 时 候 你 应 该 把 你 的 通知 的 名 字 定 义 为 一 个 字符 串 常 量 ， 就 像 你 暴露 给 其 他 类 的 其 他 字符 


串 常 量 一 样 。 你 应 该 在 公开 的 接口 文件 中 将 其 声明 为 extern 的 ， 并 且 在 对 应 的 实现 文件 里 面 定义 。 


因为 你 在 头 文件 中 暴露 了 符号 ， 所 以 你 应 该 按照 统一 的 命名 空间 前 级 法 则 ， 用 类 名 前 级 作为 这 个 通知 名 字 的 前 级 。 


同时 ， 用 一 个 Did/Will 这 样 的 动词 以 及 用 "Notifications" 后 级 来 命名 这 个 通知 也 是 一 个 好 的 实践 。 


// Foo.h 
extern NSString * const ZOCFooDidBecomeBarNotification 


// Foo.m 
NSString * const ZOCFooDidBecomeBarNotification = Q"ZOCFooDidBecomeBarNotification"; 


NSNotification 
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美化 代码 


空格 


e 缩 进 使 用 4 个 空格 。 永远 不 要 使 用 tab, 确保 你 在 Xcode 的 设置 里 面 是 这 样 设置 的 。 
e 方法 的 大 括号 和 其 他 的 大 括号 ( if / else / switch / while 等 ) 总 是 在 同一 行 开始 ， 在 新 起 一 行 结 


推荐 : 


不 


if (user.isHappy) { 
//Do something 


else { 
//Do something else 


} 


推荐 : 


if (user.isHappy) 


1 

//Do something 
} else { 

//Do something else 
ih 


该 用 新 的 方法 来 定义 。 

优先 使 用 auto-synthesis。 但 是 如 果 必 要 的 话 ， @synthesize and Gdynamic 

在 实现 文件 中 的 声明 应 该 新 起 一 行 。 

应 该 总 是 让 冒号 对 齐 。 有 一 些 方法 签名 可 能 超过 三 个 冒号 ， 用 冒号 对 齐 可 以 让 代码 更 具有 可 读 性 。 即 使 有 代码 块 存在 ， 
也 应 该 用 冒号 对 齐 方法 。 


推荐 : 


[UIView animatewithDuration:1.0 
animations:^( 
// something 
J 
completion:^(BOOL finished) { 
// something 


1l; 


不 推荐 : 


[UIView animatewithDuration:1.0 animations:^{ 
// something 

} completion:^(B00L finished) { 
// something 


3l; 


如 果 自 动 对 齐 让 可 读 性 变 得 糟糕 ， 那 么 应 该 在 之 前 把 block 定义 为 变量 ， 或 者 重新 考虑 你 的 代码 签名 设计 。 


换行 


ING 





二 化 代码 


方法 之 间 应 该 要 有 一 个 空 行 来 帮助 代码 看 起 来 清晰 且 有 组 织 。 方法 内 的 空格 应 该 用 来 分 离 功能 ， 但 是 通常 不 同 的 功能 应 
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本 指南 关注 代码 显示 效果 以 及 在 线 浏览 的 可 读 性 ， 所 以 换行 是 一 个 重要 的 主题 。 


举 个 例子 : 


self.productsRequest = [[SKProductsRequest alloc] initWithProductIdentifiers:productIdentifiers]; 


一 个 像 上 面 的 长 行 的 代码 在 第 二 行 以 一 个 间隔 〈2 个 空格 ) 延续 


self.productsRequest = [[SKProductsRequest alloc] 
initWithProductIdentifiers:productIdentifiers]; 


括号 


在 以 下 的 地 方 使 用 Egyptian 风 格 括号 GERE : 又 称 K&R 风格 ， 代 码 段 括号 的 开始 位 于 一 行 的 末尾 ， 而 不 是 另外 起 一 行 的 
风格 。 关 于 为 什么 叫做 Egyptian Brackets， 可 以 参考 http://blog.codinghorror.com/new-programming-jargon/ ) 


e 控制 语句 (if-else, for, switch) 
非 Egyptian 括号 可 以 用 在 : 


e 类 的 实现 (如 果 存在 ) 
e 方法 的 实现 
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代码 组 织 


来 自 Mattt Thompson 
code organization is a matter of hygiene (代码 组 织 是 卫生 问题 ) 


我 们 十 分 壮 成 这 名 话 。 清 晰 地 组 织 代 码 和 规范 地 进行 定义 , 是 你 对 自己 以 及 其 他 阅读 代码 的 人 的 尊重 。 


代码 组 织 
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利用 代码 块 
一 个 GCC 非常 模糊 的 特性 ， 以 及 Clang 也 有 的 特性 是 ， 代 码 块 如 果 在 闭合 的 国 括号 内 的 话 ， 会 返回 最 后 语句 的 人 


NSURL *url = ({ 
NSString *urlString = [NSString stringwithFormat:@"%@/%@", baseURLString, endpoint]; 
[NSURL URLWithString:urlString]; 
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这 个 特性 非常 适合 组 织 小 块 的 代码 ， 通 常 是 设置 一 个 类 。 他 给 了 读者 一 个 重要 的 入 口 并 且 减 少 相关 干扰 ， 能 让 读者 聚焦 于 关 
键 的 变量 和 画 数 中 。 此 外 ， 这 个 方法 有 一 个 优点 ， 所 有 的 变量 都 在 代码 块 中 ， 也 就 是 只 在 代码 块 的 区 域 中 有 效 ， 这 意味 着 可 
以 减少 对 其 他 作用 域 的 命名 污染 。 
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Pragma 


Pragma Mark 
#pragma mark - 是 一 个 在 类 内 部 组 织 代码 并 且 帮 助 你 分 组 方法 实现 的 好 办 法 。 我 们 建议 使 用 spragma mark - 来 分 离 : 


e 不 同 功能 组 的 方法 
e protocols 的 实现 
e 对 父 类 方法 的 重 写 


~ (void)dealloc { /* ... */ ) 
- (instancetype)init { /* ... */ j 


4pragma mark - View Lifecycle (View 的 生命 周期 ) 

- (void)viewDidLoad ( /* ... */ } 

- (void)viewWillAppear:(BOOL)animated { /* ... */ } 
- (void)didReceiveMemorywarning ( /* ... “/ } 


4pragma mark - Custom Accessors ( 自 定义 访问 器 ) 


- (void)setCustomProperty:(id)value ( /* ... */ ) 
~ (id)customProperty { /* ... */ } 


4pragma mark - IBActions 

- (IBAction)submitData:(id)sender { /* ... */ ) 

4pragma mark - Public 

~ (void)publicMethod { /* ... */ j 

4pragma mark - Private 

- (void)zoc privateMethod ( /* ... */ 3} 

4pragma mark - UITableViewDataSource 

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { /* ... */ ) 
4pragma mark - ZOCSuperclass 


VIDERES 








3j Zocsuperclass 的 方法 
&pragma mark - NSObject 


~ (NSString *)description ( /* ... */ F 
pec —— —————————————— aa] Ji 


上 面 的 标记 能 明显 分 离 和 组 织 代码 。 你 还 可 以 用 cmd+Click 来 快速 跳 转 到 符号 定义 地 方 。 但 是 小 心 ， 即 使 paragma mark 是 
一 门 手艺 ， 但 是 它 不 是 让 你 类 里 面 方法 数量 增加 的 一 个 理由 : 类 里 面 有 太 多 方法 说 明 类 做 了 太 多 事情 ， 需 要 考虑 重 构 了 。 


关于 pragma 
在 http://raptureinvenice.com/pragmas-arent-just-for-marks 有 很 好 的 关于 pragma 的 讨论 了 ， 在 这 边 我 们 再 做 部 分 说 明 。 


大 多 数 IOS 开发 者 平时 并 没有 和 很 多 编译 器 选项 打交道 。 一 些 选项 是 对 控制 严格 检查 (或 者 不 检查 ) 你 的 代码 或 者 错误 的 。 
有 时 候 ， 你 想 要 用 pragma 直接 产生 一 个 异常 ， 临 时 打 断 编译 器 的 行为 。 


当 你 使 用 ARC 的 时 候 ， 编 译 器 帮 你 插入 了 内 存 管 理 相 关 的 调用 。 但 是 这 样 可 能 
NSSelectorFromstring 来 动态 地 产生 一 个 selector 调用 的 时 候 ，ARC 不 知道 这 





产生 一 些 烦人 的 事情 。 上 比如 你 使 用 
个 方法 是 哪个 并 且 不 知道 应 该 用 那 种 内 存 管 理 
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方法 ， 你 会 被 提示 performSelector may cause a leak because its selector is unknown (执行 selector 可 能 导致 泄漏 ， 因 为 这 个 
selector 是 未 知 的 ) . 


如 果 你 知道 你 的 代码 不 会 导致 内 存 汇 露 ， 你 可 以 通过 加 入 这 些 代 码 忽略 这 些 警 告 


#pragma clang diagnostic push 
&pragma clang diagnostic ignored "-Warc-performSelector-leaks" 


[myObj performSelector:mySelector withObject:name]; 


&pragma clang diagnostic pop 


注意 我 们 是 如 何在 相关 代码 上 下 文中 用 pragma 停 用 -Warc-performSelector-leaks 检查 的 。 这 确保 我 们 没有 全 局 禁用 。 如 果 
全 局 禁用 ， 可 能 会 导致 错误 。 


全 部 的 选项 可 以 在 The Clang User's Manual 找到 并 且 学 习 。 


忽略 没 用 使 用 变量 的 编译 警 
告诉 你 申明 的 变量 它 将 不 会 被 使 用 ， 这 种 做 法 很 有 用 。 大 多 数 情 况 下 ， 你 希望 移 除 这 些 引 用 来 《稍微 地 ) 提高 性 能 ， 但 是 有 


时 候 你 希望 保留 它们 。 为 什么 ?或 许 它 们 以 后 有 用 ， 或 者 有 些 特性 只 是 暂时 移 除 。 无 论 如 何 ， 一 个 消除 这 些 警 告 的 好 方法 是 
用 相关 语 EM) ik 旬 行 注解 ， 使 用 #pragma unused() : 


- (NSInteger)giveMeFive 


£ 
NSString *foo; 
4pragma unused (foo) 
return 5; 

ih 


现在 你 的 代码 不 用 任何 编译 警告 了 。 注 意 你 的 pragma 需要 标记 到 问题 代码 之 下 。 
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明确 编译 器 警告 和 错误 


编译 器 是 一 个 机 器 人 ， 它 会 标记 你 代码 中 被 Clang 规则 定义 为 错误 的 地 方 。 但 是 ， 你 总 是 比 Clang 更 聪明 。i 


一 些 讨 厌 的 代码 会 导致 这 个 问题 ， 但 是 暂时 却 解决 不 了 。 你 可 以 这 样 明确 一 个 错误 : 


- (NSInteger)divide:(NSInteger)dividend by:(NSInteger)divisor 
1 
&error Whoa, buddy, you need to check for zero here! 
return (dividend / divisor); 


类 似 的 ， 你 可 以 这 样 标明 一 个 警告 


- (float)divide:(float)dividend by:(float)divisor 


1 
4warning Dude, don't compare floating point numbers like this! 
if (divisor !- 0.0) ( 
return (dividend / divisor); 
J 
else { 
return NAN; 
Ji 
} 


明确 编译 器 警告 和 错误 
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字符 串 文 档 


所 有 重要 的 方法 ， 接 口 ， 分 类 以 及 协议 定义 应 该 有 伴随 的 注释 来 解释 它们 的 用 途 以 及 如 何 使 用 。 更 多 的 例子 可 以 看 Google 
代码 风格 指南 中 的 File and Declaration Comments。 


简 而 言 之 : 有 长 的 和 短 的 两 种 字符 串 文 档 。 


短文 档 适 用 于 单行 的 文件 ， 包 括 注释 斜 杜 。 它 适合 科 短 的 函数 ， 特 别 是 (但 不 仅仅 是 ) 非 public 的 API : 
// Return a user-readable form of a Frobnozz, html-escaped. 


文本 应 该 用 一 个 动词 ("return") 而 不 是 "returns" 这 样 的 描述 。 
如 果 描 述 超 过 一 行 ， 应 改 用 长 字符 串 文档 : 


e 以 /** 开始 

e 换行 写 一 句 总结 的 话 ， 以 ?或 者 ! 或 者 . 结尾 。 
e 空 一 行 

e. 在 与 第 一 行 对 齐 的 位 置 开始 写 剩 下 的 注释 
e 最 后 用 */ 结束 。 


XS 
This comment serves to demonstrate the format of a docstring. 


Note that the summary line is always at most one line long, and 
after the opening block comment, and each line of text is preceded 
by a single space. 

tun 


一 个 函数 必须 有 一 个 字符 串 文档 ， 除 非 它 符合 下 面 的 所 有 条 件 : 
e 非 公 开 
e 很 短 
e 显而易见 


字符 串 文档 应 该 描述 函数 的 调用 符号 和 语义 ， 而 不 是 它 如 何 实 现 。 





文档 
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注释 
当 它 需要 的 时 候 ， 注 释 应 该 用 来 解释 特定 的 代码 做 了 什么 。 所 有 的 注释 必须 被 持续 维 扩 或 者 干脆 就 删 掉 。 


块 注释 应 该 被 避免 ， 代 码 本 身 应 该 尽 可 能 就 像 文 档 一 桩 表示 意图 ， 只 需要 很 少 的 打 断 注释 。 例外 : 这 不 能 适用 于 用 来 产生 文 
档 的 注释 


头 文档 


一 个 类 的 文档 应 该 只 在 h 文件 里 用 Doxygen/AppleDoc 的 语法 书写 。 方法 和 属性 都 应 该 提供 文档 。 


例子 : 
/** 
* Designated initializer. 
" 
* (Q)param store The store for CRUD operations. 
* (param searchService The search service used to query the store. 
* 
* @return A ZOCCRUDOperationsStore object. 
xf 


- (instancetype)initWithOperationsStore:(id«ZOCGenericStoreProtocol»)store 
searchService:(id«ZOCGenericSearchServiceProtocol»)searchService; 
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对 象 间 的 通讯 


对 象 之 间 需 要 通信 ， 这 也 是 所 有 软件 的 基础 。 再 非凡 的 软件 也 需要 通过 对 象 通信 来 完成 复杂 的 
计 概 念 ， 以 及 如 何 依据 这 些 概念 来 设计 出 良好 的 架构 


对 象 间 的 通讯 





目标 。 本 章 将 深入 讨论 一 些 设 
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Block 


Block 是 Objective-C 版 本 的 lambda 或 者 closure (WA) 。 


使 用 block 定义 异步 接口 : 


- (void)downloadObjectsAtPath:(NSString *)path 
completion:(void(^)(NSArray “objects, NSError *error))completion; 


当 你 定义 一 个 类 似 上 面 的 接口 的 时 候 ， 尽 量 使 用 一 个 单独 的 block 作为 接口 的 最 后 一 个 参数 。 把 需要 提供 的 数据 和 错误 信息 
整合 到 一 个 单独 block 中 ， 比 分 别提 供 成 功 和 失败 的 block 要 好 。 


以 下 是 你 应 该 这 样 做 的 原因 : 


e 通常 这 成 功 处 理 和 失败 处 理会 共享 一 些 代 码 (比如 让 一 个 进度 条 或 者 提示 消失 ) ; 
e Apple 也 是 这 样 做 的 ， 与 平台 一 致 能 够 带 来 一 些 潜在 的 好 人 处; 

e block 通常 会 有 多 行 代码 ， 如 果 不 作 为 最 后 一 个 参数 放 在 后 面 的 话 ， 会 打破 调用 点 ; 
e 使 用 多 个 block 作为 参数 可 能 会 让 调用 看 起 来 显得 很 笨拙 ， 并 且 增 加 了 复 条 性 。 


看 上 面 的 方法 ， 完 成 处 理 的 block 的 参数 很 常见 : 第 一 个 参数 是 调用 者 希望 获取 的 数据 ， 第 二 个 是 错误 相关 的 信息 。 这 里 需 
要 遵循 以 下 两 点 : 


e Æ objects 不 为 nil， 则 error. 必须 为 nil 
e 若 objects 为 nil， 则 error 必须 不 为 nil 


因为 调用 者 更 关心 的 是 实际 的 数据 ， 就 像 这 样 : 


- (void)downloadobjectsAtPath:(NSString *)path 
completion:(void(^)(NSArray “objects, NSError *error))completion { 
if (objects) { 


// do something with the data 
else { 
// some error occurred, 'error' variable should not be nil by contract 


此 外 ，Apple 提供 的 一 些 同 步 接口 在 成 功 状态 下 向 error 参数 〈 如 果 非 NULL) 写 入 了 垃圾 值 ， 所 以 检查 error 的 值 可 能 出 现 


问题 。 
深入 Block 
一 些 关键 点 : 


e block 是 在 栈 上 创建 的 

e block 可 以 复制 到 堆 上 

e Block 会 捕获 栈 上 的 变量 (或 指针 )， 将 其 复制 为 自己 私有 的 const( 变 量 )。 

e (如 果 在 Block 中 修改 Block 块 外 的 ) 栈 上 的 变量 和 指针 ， 那 么 这 些 变量 和 指针 必须 用 _ block 关键 字 申 明 ( 译 者 注 : 否则 就 
会 跟 上 面 的 情况 一 样 只 是 捕获 他 们 的 瞬时 值 )。 


如 果 block 没有 在 其 他 地 方 被 保持 ， 那 么 它 会 随 着 栈 生存 并 且 当 栈 帧 (stack frame) 返回 的 时 候 消失 。 信 存在 于 栈 上 时 ， 
block 对 对 象 访问 的 内 存 管理 和 生命 周期 没有 任何 影响 。 
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如 果 block 需要 在 栈 帧 返回 的 时 候 存在 ， 它 们 需要 明确 地 被 复制 到 堆 上 ， 这 样 ，block 会 像 其 他 Cocoa 对 象 一 样 增加 引用 计 
数 。 当 它们 被 复制 的 时 候 ， 它 会 带 着 它们 的 捕获 作用 域 一 起 ，retain 他 们 所 有 引用 的 对 象 。 


如 果 一 个 block 引 用 了 一 个 栈 变 量 或 指针 ， 那 么 这 个 block 初 始 化 的 时 候 会 拥有 这 个 变量 或 指针 的 const 副 本 ， 所 以 (被 捕获 之 
后 再 在 栈 中 改变 这 个 变量 或 指针 的 值 ) 是 不 起 作用 的 。( 译 者 注 : 所 以 这 时 候 我 们 在 block 中 对 这 种 变量 进行 赋值 会 编译 报 
错 : Variable is not assignable(missing — block type specifier) ， 因 为 他 们 是 副本 而 且 是 const 的 .具体 见 下 面 的 例 程 )。 


当 一 个 block 被 复制 后 ， _ block 声明 的 栈 变 量 的 引用 被 复制 到 了 堆 里 ， 复 制 完成 之 后 ， 无 论 是 栈 上 的 block 还 是 刚刚 产生 在 
堆 上 的 block( 栈 上 block 的 副本 ) 都 会 引用 该 变量 在 堆 上 的 副本 。 


(下 面 代码 是 译 者 加 的 ) 


CGFloat blockInt = 10; 
void (^playblock)(void) = ^( 
NSLog(Q"blockInt = 9d", blockInt); 
YN 
blockInt ++; 
playblock(); 


// 结 果 为 :blockInt = 10 


用 LLDB 来 展示 block 是 这 样子 的 : 


最 重要 的 事情 是 block 声明 的 变量 和 指针 在 block 里 面 是 作为 显示 操作 真实 值 /对 象 的 结构 来 对 待 的 。 


block 在 Objective-C 的 runtime( 运 行 时 ) 里 面 被 当 作 一 等 公民 对 待 : 他 们 有 一 个 isa 指针 ， 一 个 类 也 是 用 isa 指针 在 
Objective-C 运行 时 来 访问 方法 和 存储 数据 的 。 在 非 ARC 环境 肯定 会 把 它 搞 得 很 糟糕 ， 并 且 旺 挂 指针 会 导致 
crash. . block 仅仅 对 block 内 的 变量 起 作用 ， 它 只 是 简单 地 告诉 block : 






































嗨 ， 这 个 指针 或 者 原始 的 类 型 依赖 它们 在 的 栈 。 请 


不 要 retain 它 。 谢谢 ， 哥 们 。 


一 个 栈 上 的 新 变量 来 引用 它 。 我 是 说 ， 请 对 它 进行 双重 解 引 用 ， 





如 果 在 定义 之 后 但 是 block 没有 被 调用 前 ， 对 象 被 释放 了 ， 那 么 block 的 执行 会 导致 crash。 — block 变量 不 会 在 block 中 
被 持 有 ， 最 后 … 指针 、 引 用 、 解 引用 以 及 引用 计数 变 得 一 团 糟 。 


self 的 循环 引用 

当 使 用 代码 块 和 异步 分 发 的 时 人 息 ， 要 注意 避免 引用 循环 。 总 是 使 用 weak 来 引用 对 象 ， 避 免 引 用 循环 。 ( 译 者 注 : 这 里 更 为 
优雅 的 方式 是 采用 影子 变量 @weakify/@strongify 这 里 有 更 为 详细 的 说 明 ) 此外， 把 持 有 block 的 属性 设置 为 nil (比如 
self.completionBlock = nil) 是 一 个 好 的 实践 。 它 会 打破 block 捕获 的 作用 域 带 来 的 引用 循环 。 


例子 : 


— weak . typeof(self) weakSelf = self; 

[self executeBlock:^(NSData *data, NSError *error) ( 
[weakSelf doSomethingWithData:data]; 

}]; 


不 要 这 样 : 
[self executeBlock:^(NSData “data, NSError *error) 4 
[self doSomethingwithData:data]; 
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3l; 
多 个 语句 的 例子 : 


— weak . typeof(self)weakSelf = self; 
[self executeBlock:^(NSData *data, NSError *error) ( 
— Strong . typeof(weakSelf) strongSelf = weakSelf; 
if (strongSelf) 4 
[strongSelf doSomethingWithData:data]; 
[strongSelf doSomethingWithData:data]; 


— weak . typeof(self)weakSelf = self; 

[self executeBlock:^(NSData “data, NSError *error) { 
[weakSelf doSomethingWithData:data]; 
[weakSelf doSomethingWithData:data]; 

}]; 


你 应 该 把 这 两 行 代码 作为 snippet 加 到 Xcode 里 面 并 且 总 是 这 样 使 用 它们 。 


— weak . typeof(self)weakSelf = self; 
— Strong _ typeof(weakSelf)strongSelf = weakSelf; 


这 里 我 们 来 讨论 下 block Erf self 的 — weak 和 _ strong 限定 词 的 一 些微 妙 的 地 方 。 简 而 吉之 ， 我 们 可 以 参考 self 在 
block 里 面 的 三 种 不 同情 况 。 


1. 直接 在 block 里 面 使 用 关键 词 self 
2. f£ block 外 定义 一 个 _weak 的 引用 到 self， 并 且 在 block 里 面 使 用 这 个 弱 引 用 
3. 在 block 外 定义 一 个 _weak 的 引用 到 self， 并 在 在 block 内 部 通过 这 个 弱 引 用 定义 一 个 _ strong 的 引用 。 


方案 1. 直接 在 block 里 面 使 用 关键 词 self 


如 果 我 们 直接 在 block 里 面 用 self 关键 字 ， 对 象 会 在 block 的 定义 时 候 被 retain， (实际 上 block 是 copied 但 是 为 了 简单 我 
们 可 以 忽略 这 个 ) 。 


一 个 const 的 对 self 的 引用 在 block 里 面 有 自己 的 位 置 并 且 它 会 影响 对 象 的 引用 计数 。 


如 果 这 个 block 被 其 他 的 类 使 用 并 且 ( 或 者 ) 彼 此 间 传 来 传 去 ， 我 们 可 能 想 要 在 block 中 保留 self， 就 像 其 他 在 block 中 使 用 的 
对 象 一 样 . 因为 他 们 是 block 执 行 所 需要 的 . 


dispatch block t completionBlock = ^( 
NSLog(Q"*Q", self); 
Hi 


MyViewController *myController = [[MyViewController alloc] init...]; 
[self presentViewController:myController 
animated:YES 
completion:completionHandler]; 


没 哈 大 不 了 。 但 是 如 果 通 过 一 个 属性 中 的 self 保留 了 这 个 block (就 像 下 面 的 例 程 一 样 ) ,对 象 ( self ) 保 留 了 block 会 怎么 
样 呢 ? 
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self.completionHandler = 人 ^{ 
NSLog(Q"*«Q", self); 
} 


MyViewController *myController = [[MyViewController alloc] init...]; 
[self presentViewController:myController 
animated:YES 
completion:self.completionHandler]; 


这 就 是 有 名 的 retain cycle, 并 且 我 们 通常 应 该 避免 它 。 这 种 情况 下 我 们 收 到 CLANG 的 警告 : 





Capturing 'self' strongly in this block is likely to lead to a retain cycle (在 block 里 面 发 现 了 “self” 的 强 引 用 ， 可 能 会 导 至 





«] 
所 以 — weak 就 有 用 武之 地 了 。 





方案 2. 在 block 外 定义 一 个 weak 的 引用 到 self， 并 且 在 block 里 面 使 用 这 个 弱 引 用 


这 样 会 避免 循 坏 引用 ， 也 是 通常 情况 下 我 们 的 block 作 为 类 的 属性 被 self retain 的 时 候 会 做 的 。 


— weak typeof(self) weakSelf = self; 
self.completionHandler = ^( 
NSLog(@"%@", weakSelf); 


}; 


MyViewController *myController = [[MyViewController alloc] init...]; 
[self presentViewController:myController 
animated: YES 
completion:self.completionHandler]; 


这 个 情况 下 block 没有 retain 对 象 并 且 对 象 在 属性 里 面 retain 了 block 。 所 以 这 样 我 们 能 保证 了 安全 的 访问 sel, 不 过 糟糕 
的 是 ， 它 可 能 被 设置 成 nil 的。 问题 是 : 如 何 让 self 在 block 里 面 安全 地 被 销毁 。 


考虑 这 么 个 情况 : block 作为 属性 (property) 赋 值 的 结果 ， 从 一 个 对 象 被 复制 到 另 一 个 对 象 (如 myController)， 在 这 个 复制 的 
block 执行 之 前 ， 前 者 〈 即 之 前 的 那个 对 象 ) 已 经 被 解除 分 配 。 


下 面 的 更 有 意思 。 
方案 3. 在 block 外 定义 一 个 weak 的 引用 到 self， 并 在 在 block 内 部 通过 这 个 弱 引 用 定义 一 个 _ strong 的 引用 


你 可 能 会 想 ， 首 先 ， 这 是 避免 retain cycle 警告 的 一 个 技巧 。 这 不 是 重点 ， 这 个 self 的 强 引用 是 在 block 执行 时 被 创建 的 ， 但 
是 否 使 用 self 在 block 定义 时 就 已 经 定 下 来 了 ， 因此 self (在 block 执 行 时 ) 会 被 retain。 


Apple 文档 中 表示 "为 了 non-trivial cycles ， 你 应 该 这 样 " 


MyViewController *myController = [[MyViewController alloc] init...]; 


Boe 
MyViewController * _ weak weakMyController = myController; 
myController.completionHandler =  ^(NSInteger result) 4 
MyViewController *strongMyController - weakMyController; 
if (strongMyController) { 
[strongMyController dismissViewControllerAnimated: YES completion:nil]; 
Kf 
J 
else { 
// Probably nothing... 
J; 
J; 
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首先 ， 我 觉得 这 个 例子 看 起 来 是 错误 的 。 如 果 block 本 身 在 completionHandler 属性 中 被 retain T, 384. self 如 何 被 delloc 
和 在 block 之 外 赋值 为 nil E? completionHandler 属性 可 以 被 声明 为 assign 或 者 unsafe unretained 的 ， 来 允许 对 象 在 
block 被 传递 之 后 被 销毁 。 


我 不 能 理解 这 样 做 的 理由 ， 如 果 其 他 对 象 需要 这 个 对 象 (self) ，block 被 传递 的 时 候 应 该 retain 对 象 ， 所 以 block 应 该 不 被 
作为 属性 存储 。 这 种 情况 下 不 应 该 用 _ weak / strong 


总 之 ， 其 他 情况 下 ， 希 望 weakSelf 变 成 nil 的 话 ， 就 像 第 二 种 情况 解释 那么 写 〈 在 block 之 外 定义 一 个 弱 应 用 并 且 在 block 
里 面 使 用 ) 。 


还 有 ，Apple 的 "trivial block" 是 什么 呢 。 我 们 的 理解 是 trivial block 是 一 个 不 被 传送 的 block ， 它 在 一 个 良好 定义 和 控制 的 作 
用 域 里 面 ，weak 修饰 只 是 为 了 避免 循环 引用 。 


虽然 有 Kazuki Sakamoto 和 Tomohiko Furumoto) 讨论 的 一 些 的 在 线 参考 , Matt Galloway 的 (Effective Objective-C 2.0 和 
Pro Multithreading and Memory Management for iOS and OS X ， 大 多 数 开 发 者 始终 没有 弄 清 楚 概念 。 


在 block 内 用 强 引 用 的 优点 是 ， 抢 占 执行 的 时 候 的 鲁 棒 性 。 在 block 执行 的 时 候 , 再 次 温 故 下 上 面 的 三 个 例子 : 
方案 1. 直接 在 block 里 面 使 用 关键 词 self 


如 果 block 被 属性 retain, self 和 block 之 间 会 有 一 个 循环 引用 并 且 它 们 不 会 再 被 释放 。 如 果 block 被 传送 并 且 被 其 他 的 对 象 
copy 了 ，self 在 每 一 个 copy 里 面 被 retain 


方案 2. 在 block 外 定义 一 个 _weak 的 引用 到 self， 并 且 在 block 里 面 使 用 这 个 弱 引 用 


TE block 是 否 通过 属性 被 retain ， 这 里 都 不 会 发 生 循环 引用 。 如 果 block 被 传递 或 者 copy 了 ， 在 执行 的 时 候 ，weakSelf 
可 能 已 经 变 成 nil。 


block 的 执行 可 以 抢占 ， 而 且 对 weakSelf 指针 的 调用 时 序 不 同 可 以 导致 不 同 的 结果 (如 : 在 一 个 特定 的 时 序 下 weakSelf 可 能 
会 变 成 nil )。 


— weak typeof(self) weakSelf = self; 
dispatch block t block = ^( 


[weakSelf doSomething]; // weakSelf !- nil 
// preemption, weakSelf turned nil 
[weakSelf doSomethingElse]; // weakSelf -- nil 


}; 


方案 3. 在 block 外 定义 一 个 weak 的 引用 到 self， 并 在 在 block 内 部 通过 这 个 弱 引 用 定义 一 个 _ strong 的 引用 。 


不 管 block 是 否 通过 属性 被 retain ， 这 里 也 不 会 发 生 循环 引用 。 如 果 block 被 传递 到 其 他 对 象 并 且 被 复制 了 ， 执 行 的 时 候 ， 
weakSelf 可 能 被 nil， 因 为 强 引 用 被 赋值 并 且 不 会 变 成 nil 的 时 候 ， 我 们 确保 对 象 在 block 调用 的 完整 周期 里 面 被 retain 了 ， 如 
果 抢 占 发 生 了 ， 随 后 的 对 strongSelf 的 执行 会 继续 并 且 会 产生 一 样 的 值 。 如 果 strongSelf 的 执行 到 nil， 那 么 在 block 不 能 
确 执 行 前 已 经 返回 了 。 


— weak typeof(self) weakSelf = self; 
myObj.myBlock = ^( 
— strong typeof(self) strongSelf = weakSelf; 
if (strongSelf) 4 





[strongSelf doSomething]; // strongSelf !- nil 
// preemption, strongSelf still not nil (抢占 的 时 候 ，strongSelLf 还 是 非 nil 的 ) 
[strongSelf doSomethingElse]; // strongSelf !- nil 
y 
else { 
/ Probably nothing... 
return; 
J 


}; 


Blocks 57 


18. 5- Objective-C 编程 艺术 





在 ARC 条 件 中 ， 如 果 尝 试用 -> 符号 访问 一 个 实例 变量 ， 编 译 器 会 给 出 非常 清晰 的 错误 信息 : 
Dereferencing a weak pointer is not allowed due to possible null value caused by race condition, assign it to a stror 
«| ] 


可 以 用 下 面 的 代码 展示 








— weak typeof(self) weakSelf = self; 
myObj.myBlock = ^( 
id localVal = weakSelf-»someIVar; 


e 方案 1: 只 能 在 block 不 是 作为 一 个 property 的 时 候 使 用 ， 否 则 会 导致 retain cycle, 
e 方案 2: 当 block 被 声明 为 一 个 property 的 时 候 使 用 。 


e 方案 3: 和 并 发 执行 有 关 。 当 涉及 异步 的 服务 的 时 人 息 ，block 可 以 在 之 后 被 执行 ， 并 且 不 会 发 生 关 于 self 是 否 存在 的 问 


题 。 


Blocks 58 


fi. 57- Objective-C 编程 艺术 





委托 和 数据 源 

( 译 者 注 : 这 里 是 说 两 种 模式 : 委托 模式 以 及 数据 源 模式 ) 

委托 模式 是 Apple 的 框架 里 面 使 用 广泛 的 模式 ， 同 时 它 是 四 人 帮 有 的 书 “ 设 计 模 式 " 中 的 重要 模式 之 一 。 委 托 代理 模式 是 单 向 
的 ， 消 息 的 发 送 方 (委托 方 ) 需要 知道 接收 方 (RED) 是 谁 ， 反 过 来 就 没有 必要 了 。 对 象 之 间 耦 合 较 松 ， 发 送 方 仅 需 知道 
它 的 代理 方 是 否 遵守 相关 protocol 即 可 。 


本 质 上 ， 委 托 模式 仅 需要 代理 方 提供 一 些 回调 方法 ， 即 代理 方 需要 实现 一 系列 空 返回 值 的 方法 。 


不 幸 的 是 Apple 的 API 并 没有 遵守 这 个 原则 ， 开 发 者 也 效仿 Apple 进入 了 一 个 误区 。 典 型 的 例子 就 是 UlTableViewDelegate 
协议 。 


它 的 一 些 方法 返回 void 类 型 ， 就 像 我 们 所 说 的 回调 : 


- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSindexPath *)indexPath; 
- (void)tableView:(UriTableView *)tableView didHighlightRowAtIndexPath:(NSIindexPath *)indexPath; 


但 是 其 他 的 就 不 是 那么 回 事 : 


- (CGFloat)tableView: (UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath; 
- (BOOL)tableView:(UITableView *)tableView canPerformAction:(SEL)action forRowAtIndexPath:(NSIndexPath *)indexPath with 


aj MTS 


当 委 托 者 询问 代理 者 一 些 信息 的 时 候 ， 这 就 暗示 着 信息 是 从 代理 者 流向 委托 者 而 非 相反 的 过 程 。 这 ( 译 者 注 : 委托 者 
==Data==> 代理 者 ) 是 概念 性 的 不 同 ， 须 用 另 一 个 新 的 名 字 来 描述 这 种 模式 : 数据 源 模式 。 





可 能 有 人 会 说 Apple 有 一 个 UlTableViewDataSouce protocol 来 做 这 个 〈 虽 然 使 用 委托 代理 模式 的 名 字 ) ， 但 是 实际 上 它 的 
方法 是 用 来 提供 真实 的 数据 应 该 如 何 被 展示 的 信息 的 。 


- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath; 
- (NSInteger)numberOfSectionsInTableView:(UiTableView *)tableView; 


此 外 ， 以 上 两 个 方法 Apple 混合 了 展示 层 和 数据 层 ， 这 显 的 非常 糟糕 ， 但 是 很 少 的 开发 者 感到 糟糕 。 而 且 我 们 在 这 里 把 空 返 
回 值 和 非 空 返回 值 的 方法 都 天 真 地 叫做 代理 方法 。 


为 了 分 离 概念 ， 我 们 应 该 这 样 做 : 


e 委托 模式 (delegate pattern) : 事件 发 生 的 时 候 ， 委 托 者 需要 通知 代理 者 。 
e 数据 源 模式 (datasource pattern): 委托 者 需要 从 数据 源 对 象 拉 取 数据 。 


这 个 是 实际 的 例子 : 


Qclass zOCSignUpViewController; 


Qprotocol ZOoCSignUpViewControllerDelegate «NSObject» 
- (void)signUpViewControllerDidPressSignUpButton:(ZOCSignUpViewController *)controller; 
Qend 


Qprotocol ZOCSignUpViewControllerDataSource «NSObject» 
- (ZOCUserCredentials *)credentialsForSignUpViewController:(ZOCSignUpViewController *)controller; 
Qend 
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Qinterface ZOCSignUpViewController : UIViewController 


Gproperty (nonatomic, weak) id«ZzocsignUpViewControllerDelegate» delegate; 
Gproperty (nonatomic, weak) id«ZzocsignUpViewControllerDataSource» dataSource; 


Qend 


代理 方法 必须 以 调用 者 ( 即 委托 者 ) 作 为 第 一 个 参数 ， 就 像 上 面 的 例子 一 样 。 否 则 代理 者 无 法 区 分 不 同 的 委托 者 实例 。 换 名 话 
说 ， 调 用 者 (委托 者 ) 没 有 被 传递 给 代理 ， 那 就 没有 方法 让 代理 处 理 两 个 不 同 的 委托 者 ， 所 以 下 面 这 种 写法 人 神 共 怒 : 


- (void)calculatorDidCalculateValue:(CGFloat)value; 


默认 情况 下 ， 代 理 者 需要 实现 protocol 的 方法 。 可 以 用 erequired 和 Goptional 关键 字 来 标记 方法 是 否 是 必要 的 还 是 可 选 的 
(默认 是 erequired : 必需 的 )。 


Qprotocol ZOCSignUpViewControllerDelegate «NSObject» 

Qrequired 

- (void)signUpViewController:(ZOCSignUpViewController *)controller didProvideSignUpInfo:(NSDictionary *)dict; 
Qoptional 

- (void)signUpViewControllerDidPressSignUpButton:(ZOCSignUpViewController *)controller; 

Qend 


对 于 可 选 的 方法 ， 委 托 者 必须 在 发 送 消息 前 检查 代理 是 否 确实 实现 了 特定 的 方法 (否则 会 crash) 


if ([self.delegate respondsToSelector :@selector (signUpViewControllerDidPressSignUpButton:)]) { 
[self.delegate signUpViewControllerDidPressSignUpButton:self]; 


继承 


有 时 候 你 可 能 需要 重 载 代 理 方法 。 考 虑 有 两 个 UIViewController 子 类 的 情况 : UlViewControllerA 和 UIViewControllerB， 有 
下 面 的 类 继承 关系 。 


UIViewControllerB < UIViewControllerA < UIViewController 


UIViewControllerA conforms to uUrrableviewbelegate and implements - (CcGFloat)tableView:(UITableView *)tableView 


heightForRowAtIndexPath:(NSIndexPath *)indexPath . 


UIViewControllerA 遵从 UITableViewDelegate 并 且 实现 了 - (CGFloat)tableView:(UITableView *)tableView 


heightForRowAtIndexPath:(NSIndexPath *)indexPath . 


你 可 能 会 想 要 在 urviewcontrollerB 中 提供 一 个 不 同 的 实现 ， 这 个 实现 可 能 是 这 样子 的 : 


- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath { 
CGFloat retVal - 0; 
if ([super respondsToSelector:(selector(tableView:heightForRowAtIndexPath:)]) 4 
retVal - [super tableView:self.tableView heightForRowAtIndexPath:indexPath]; 


Ji 
return retVal + 10.0f; 


但 是 如 果 超 类 ( urviewcontrollerA ) 没 有 实现 这 个 方法 呢 ? 


此 时 调用 [super respondsToselector:@selector(tableview:heightForRowAtIndexPath: )] 方法 ， 将 使 用 NSObject 的 实现 ， 在 
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self 上 下 文 深入 查找 并 且 明 确 seit 实现 了 这 个 方法 (因为 UrTableViewcontrollerA 遵从 UITableviewpelegate ) ， 但 是 应 
用 将 在 下 一 行 发 生前 溃 ， 并 提示 如 下 错误 信息 : 


* Terminating app due to uncaught exception 'NSInvalidArgumentException', reason: '-[UlViewControllerB 
tableView:heightForRowAtIndexPath:]: unrecognized selector sent to instance 0x8082820' 


这 种 情况 下 我 们 需要 来 询问 特定 的 类 实例 是 否 可 以 响应 对 应 的 selector。 下 面 的 代码 提供 了 一 个 小 技巧 : 
``obj-c 
- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath { 
CGFloat retVal = 0; 


if ([[UIViewControllerA class] instancesRespondToSelector:Qselector(tableView:heightForRowAtIndexPath:)]) ( 
retVal - [super tableView:self.tableView heightForRowAtIndexPath:indexPath]; 


J 
return retVal + 10.0f; 


就 像 上 面 笑 陋 的 代码 ， 通 常 它 会 是 更 好 的 设计 架构 的 方式 ， 因 为 这 种 方式 代理 方法 不 需要 被 重 写 。 


多 重 委托 


多 重 委托 是 一 个 非常 基础 的 概念 ， 但 是 ， 大 多 数 开 发 者 对 此 非常 不 熟悉 而 使 用 NSNotifications。 就 像 你 可 能 注意 到 的 ， 委 托 
和 数据 源 是 对 象 之 间 的 通讯 模式 ， 但 是 只 涉及 两 个 对 象 : 委托 者 和 委托 。 


数据 源 模式 强制 一 对 一 的 关系 ， 当 发 送 者 请 求 信息 时 有 且 只 能 有 一 个 对 象 来 响应 。 对 于 代理 模式 而 言 这 会 有 些 不 同 ， 我 们 有 
足够 的 理由 要 去 实现 很 多 代理 者 等 待 (唯一 委托 者 的 ) 回 调 的 场景 。 


一 些 情况 下 至 少 有 两 个 对 象 对 特定 委托 者 的 回调 感 兴趣 ， 而 后 者 ( 即 委托 者 ) 需 要 知道 他 的 所 有 代理 。 这 种 方法 在 分 布 式 系统 
下 更 为 适用 并 且 广 泛 使 用 于 大 型 软件 的 复杂 信息 流程 中 。 


多 重 委托 可 以 用 很 多 方式 实现 ， 但 读者 更 在 乎 找到 适合 自己 的 个 人 实现 。Luca Bernardi 在 他 的 LBDelegateMatrioska 中 提供 
了 上 述 范式 的 一 个 非常 简洁 的 实现 。 


里 给 出 一 个 基本 的 实现 ,方便 你 更 好 地 理解 这 个 概念 。 即 使 在 Cocoa 中 也 有 一 些 在 数据 结构 中 保存 weak 引用 来 避免 引用 循 
环 的 方法 ， 这 里 我 们 使 用 一 个 类 来 保留 代理 对 象 的 weak 引用 (就 像 单一 代理 那样 ): 


Qinterface ZOCWeakObject : NSObject 


pu ao sd) readoniy Wok) id ide 





+ (instancetype)weakObjectWithObject:(id)object; 
- (instancetype)initWithObject:(id)object; 


Qend 

Qinterface ZOCWeakObject () 

Gproperty (nonatomic, weak) id object; 
Qend 


(implementation ZOCWeakObject 


+ (instancetype)weakObjectWithObject:(id)object { 
return [[[self class] alloc] initWithObject:object]; 
Hi 


- (instancetype)initWithObject:(id)object { 
if ((self = [super init])) 4 
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_object = object; 


} 


return self; 


- (BO0L)isEqual:(id)object { 
if (self == object) ( 
return YES; 


if (![object isKindoOfClass:[object class]]) 4 
return NO; 


return [self isEqualToWeakObject:(ZOCWeakObject *)object]; 


- (BO0L)isEqualToWeakObject:(ZOCWeakObject *)object ( 
if (!object) ( 
return NO; 


BOOL objectsMatch - [self.object isEqual:object.object]; 
return objectsMatch; 


- (NSUInteger)hash { 
return [self.object hash]; 


Qend 


使 用 weak 对 象 来 实现 多 重 代理 的 简单 组 件 : 


Qprotocol ZOCServiceDelegate «NSObject» 

Qoptional 

- (void)generalService:(ZOCGeneralService *)service didRetrieveEntries:(NSArray *)entries; 
Qend 


Qinterface ZOCGeneralService : NSObject 

- (void)registerDelegate:(id«ZOCServiceDelegate»)delegate; 

- (void)deregisterDelegate:(id«ZOCServiceDelegate»)delegate; 
Qend 


Qinterface ZOCGeneralservice () 
Qproperty (nonatomic, strong) NSMutableSet *delegates; 
Qend 


Qimplementation ZOCGeneralService 
- (void)registerDelegate:(id«ZOCServiceDelegate»)delegate { 
if ([delegate conformsToProtocol:Gprotocol(zOCServiceDelegate)]) € 
[self.delegates addObject:[[ZOCWeakObject alloc] initWithObject:delegate]]; 


- (void)deregisterDelegate:(id«ZOCServiceDelegate»)delegate { 
if ([delegate conformsToProtocol:QGprotocol(zOCServiceDelegate)]) € 
[self.delegates removeObject:[[ZOCWeakObject alloc] initWithObject:delegate]]; 


- (void) notifyDelegates ( 


for (ZOoCWeakObject “object in self.delegates) { 
if (object.object) { 
if ([object.object respondsToSelector:(selector(generalService:didRetrieveEntries:)]) { 
[object.object generalService:self didRetrieveEntries:entries]; 
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@end 
在 registerDelegate: 和 deregisterDelegate: 方法 的 帮助 下 ， 连 接 /解除 组 件 之 间 的 联系 很 简单 : 在 某 些 时 间 点 上 ， 如 果 代 
理 不 需要 接收 委托 者 的 回调 ， 仅 仅 需 要 'unsubscribe'. 


当 不 同 的 view 等 待 同一 个 回调 来 更 新 界面 展示 的 时 候 ， 这 很 有 用 : 如 果 view 只 是 暂时 隐藏 (但 是 仍然 存在 ) ， 它 仅仅 需要 
取消 对 回调 的 订阅 。 
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面向 切面 编程 


Aspect Oriented Programming (AOP， 面 向 切面 编程 ) 在 Objective-C 社区 内 没有 那么 有 名 ， 但 是 AOP 在 运行 时 可 以 有 巨大 
威力 。 但 是 因为 没有 事实 上 的 标准 ，Apple 也 没有 开 箱 即 用 的 提供 ， 也 显得 不 重要 ， 开 发 者 都 不 怎么 考虑 它 。 


引用 Aspect Oriented Programming 维基 页 面 : 


An aspect can alter the behavior of the base code (the non-aspect part of a program) by applying advice (additional 
behavior) at various join points (points in a program) specified in a quantification or query called a pointcut (that 
detects whether a given join point matches). (一 个 切面 可 以 通过 在 多 个 join points 中 附加 的 行为 来 改变 基础 代码 的 行 
为 (程序 的 非 切面 的 部 分 ) ) 




































































在 Objective-C 的 世界 里 ， 这 意味 着 使 用 运行 时 的 特性 来 为 指定 的 方法 追加 切面 。 切 面 所 附加 的 行为 可 以 是 这 样 的 : 


e 在 类 的 特定 方法 调用 前 运行 特定 的 代码 
e 在 类 的 特定 方法 调用 后 运行 特定 的 代码 
e. 增加 代码 来 蔡 代 原来 的 类 的 方法 的 实现 


有 很 多 方法 可 以 达成 这 些 目的 ， 但 是 我 们 没有 深入 挖掘 ， 不 过 它们 主要 都 是 利用 了 运行 时 。 Peter Steinberger $ T —1 
库 ，Aspects 完美 地 适 配 了 AOP 的 思路 。 我 们 发 现 它 值得 信赖 以 及 设计 得 非常 优秀 ， 所 以 我 们 就 在 这 边 作 为 一 个 简单 的 例 
Fa 


对 于 所 有 的 AOP 库 ， 这 个 库 用 运行 时 做 了 一 些 非常 酷 的 魔法 ， 可 以 替换 或 者 增加 一 些 方法 (Hb method swizzling 技术 更 有 技 
巧 性 ) 


Aspect 的 API 有 趣 并 且 非 常 强大 : 


+ (id«AspectToken»)aspect hookSelector:(SEL)selector 
withOptions:(AspectOptions)options 
usingBlock:(id)block 
error:(NSError **J)error; 
- (id«AspectToken»)aspect hookSelector:(SEL)selector 
withOptions:(AspectOptions)options 
usingBlock:(id)block 
error:(NSError **J)error; 


比如 ， 下 面 的 代码 会 对 于 执行 Myclass 类 的 mywethod: (实例 或 者 类 的 方法 ) 执行 块 参数 。 


[MyClass aspect hookSelector:()selector(myMethod:) 
withOptions:AspectPositionAfter 
usingBlock:^(id«AspectInfo» aspectInfo) { 


error:nil]; 
换 一 句 话说 : 任意 的 Myclass 类 型 的 对 象 (或 者 是 类 型 本 身 当 这 个 selector 方法 为 类 方法 时 ) 的 @selector 方法 执行 完 后 
就 会 执行 这 个 代码 中 块 参数 所 提供 的 代码 。 
我 们 为 Myclass 类 的 myMethod: 方法 增加 了 切面 。 
通常 AOP 被 用 来 实现 横向 切面 。 统 计 与 日 志 就 是 一 个 完美 的 例子 。 


下 面 的 例子 里 面 ， 我 们 会 用 AOP 用 来 进行 统计 。 统 计 是 iOS 项 目 里 面 一 个 热门 的 特性 ， 有 很 多 选择 比如 Google Analytics, 
Flurry MixPanel, 等 等 . 
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大 部 分 统计 框架 都 有 教程 来 指导 如 何 追 踪 特 定 的 界面 和 事件 ， 包 括 在 每 一 个 类 里 写 几 行 代码 。 


在 Ray Wenderlich 的 博客 里 有 文章 和 一 些 示例 代码 ， 通 过 在 你 的 view controller 里 面 加 入 Google Analytics 3 


- (void)logButtonPress:(UiButton *)button { 
id«GAITracker» tracker = [[GAI sharedInstance] defaultTracker]; 
[tracker send:[[GAIDictionaryBuilder createEventWithCategory .:("UX" 
action:Q"touch" 
label:[button.titleLabel text] 
value:nil] build]]; 


4 


[u| 
S 








上 面 的 代码 在 按钮 点 击 的 时 候 发 送 了 特定 的 上 下 文 事件 。 但 是 当 你 想 追 踪 屏 幕 的 时 4 


bb 
Kik 
E. 


RS. 


RE 


- (void)viewDidAppear :(B00L)animated { 
[super viewDidAppear :animated]; 


id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker]; 
[tracker set:kGAIScreenName value:@"Stopwatch"]; 
[tracker send:[[GAIDictionaryBuilder createAppView] build]]; 


进行 统计 。 


对 于 大 部 分 有 经 验 的 iOS 工 程 策 ， 这 看 起 来 不 是 很 好 的 代码 。 我 们 让 view controller 变 得 更 粳 糕 了 。 因 为 我 们 加 入 了 统计 事 
件 的 代码 ， 但 是 它 不 是 view controller 的 职能 。 你 可 以 反驳 ， 因 为 你 通常 有 特定 的 对 象 来 负责 统计 追踪 ， 并 且 你 将 代码 注入 


了 view controller ， 但 是 无 论 你 隐藏 逻辑 ， 问 题 仍然 存在 : 你 最 后 还 是 在 viewpidappear: 后 插入 了 代码 。 


我 们 可 以 在 类 的 viewpidAppear: 方法 上 使 用 AOP 来 追踪 屏幕 ， 并 且 我 们 可 以 使 用 同样 的 方法 在 其 他 我 们 感 兴趣 的 方法 上 添 


加 事件 追踪 。 比 如 当 用 户 点 击 某 个 按钮 时 (比如 :一 般 调用 对 应 的 IBAction). 
方法 很 简洁 且 不 具 侵入 性 : 


e view controller 不 会 被 不 属于 它 的 代码 污染 

e. 为 所 有 加 入 到 我 们 代码 的 切面 指定 一 个 SPOC xt (single point of customization)? £t T STRE 

e SPOC 应 该 在 App 刚 开始 启动 的 时 候 用 来 添加 切面 

e 如 果 SPOC 文 件 异常 ,至 少 有 一 个 selector 或 者 类 识别 不 出 来 ， Cn ed a pein 


e 公司 负责 统计 的 团队 通常 会 提供 统计 文档 ， 罗 列 出 需要 追踪 的 事件 。 这 个 文档 可 以 很 容易 映射 到 一 个 SPOC 文件 。 


e 追踪 逻辑 抽象 化 之 后 ， 扩 展 到 很 多 其 他 统计 框架 会 很 方便 
e 对 于 屏幕 视图 ， 对 于 需要 定义 selector 的 方法 ， 只 需要 在 SPOC 文件 修改 相关 的 类 (相关 的 切面 会 加 入 到 





viewDidAppear: 方法 ) 。 如 果 要 同时 发 送 屏幕 视图 和 事件 ， 需 要 (依靠 统计 提供 方 ) 提供 一 个 追踪 的 标示 或 者 可 能 还 需 


要 提供 其 他 的 元 信息 /So 


我 们 可 能 一 个 SPOC 文件 类 似 下 面 的 (同样 的 一 个 .plist 文件 会 适 配 ) 


NSDictionary *analyticsConfiguration() 


1 
return @{ 
Q"'trackedScreens" : Q[ 
ec 
Q"class" : Q"ZzocMainViewController", 
Q"label" : Q"Main screen" 
J 
Ih 
@"trackedEvents" : @[ 
@{ 
@"class" : @"ZOCMainViewController", 
@"selector" : @"loginViewFetchedUserInfo:user:", 
@"label" : @"Login with Facebook" 
} 
@{ 


@"class" : @"ZOCMainViewController", 
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Q"selector" : Q"loginViewShowingLoggedOutUser:", 
Q"label" : Q"Logout with Facebook" 


} 

@{ 
@"class" : @"ZOCMainViewController", 
@"selector" : @"loginView:handleError:", 
@"label" : @"Login error with Facebook" 
} 

@{ 
@"class" : @"ZOCMainViewController", 
@"selector" : @"shareButtonPressed:", 
@"label" : @"Share button" 
J 

] 


u 


提 及 的 架构 托管 在 Github 的 EF Education First Fh. 


- (void)setupWwithConfiguration:(NSDictionary *)configuration 
1 
// screen views tracking 
for (NSDictionary *trackedScreen in configuration[Q"trackedScreens"]) { 
Class clazz = NSClassFromString(trackedScreen[Q"class"]); 


[clazz aspect hookSelector:(selector(viewDidAppear:) 
withOptions:AspectPositionAfter 
usingBlock:^(id«AspectInfo» aspectInfo) { 

dispatch async(dispatch get global queue(DISPATCH QUEUE PRIORITY DEFAULT, 
Wi 

NSString *viewName = trackedScreen[@"label"]; 

[tracker trackScreenHitWithName:viewName]; 

35 
J 
error:nil]; 


}]; 


// events tracking 

for (NSDictionary *trackedEvents in configuration[@"trackedEvents"]) { 
Class clazz = NSClassFromString(trackedEvents[Q"class"]); 
SEL selektor = NSSelectorFromString(trackedEvents[Q"selector"]); 


[clazz aspect hookSelector:selektor 
withOptions:AspectPositionAfter 
usingBlock:^(id«AspectInfo» aspectInfo) { 
dispatch async(dispatch get global queue(DISPATCH QUEUE PRIORITY DEFAULT, 
AU 
UserActivityButtonPressedEvent *buttonPressEvent =N 
[UserActivityButtonPressedEvent N 
eventWithLabel:trackedEvents[Q0"1abel"]]; 
[tracker trackEvent :buttonPressEvent]; 
35 
} 
error:nil]; 


}]; 
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这 里 有 一 些 和 风格 指南 有 关 的 葵 果 的 文档 : 


e The Objective-C Programming Language 

e Cocoa Fundamentals Guide 

e Coding Guidelines for Cocoa 

e iOS App Programming Guide 

e Apple Objective-C conventions: 来 自 莹 果 的 代码 约定 


其 他 : 


e Objective-Clean: an attempt to write a standard for writing Objective-C code with Xcode integration; 
e Uncrustify: source code beautifier. 


其 他 的 Objective-C 风格 指南 
这 里 有 一 些 和 风格 指南 有 关 的 荣 果 的 文档 。 如 果 有 一 些 本 书 没有 涉猎 的 地 方 ， 你 或 许 能 在 这 些 之 中 找到 详细 说 明 。 
来 自 Apple 的 : 


e The Objective-C Programming Language 
e Cocoa Fundamentals Guide 

e Coding Guidelines for Cocoa 

e iOS App Programming Guide 


来 自 社区 的 : 


e NYTimes Objective-C Style Guide 
e Google 

e GitHub 

e Adium 

e Sam Soffes 

e CocoaDevCentral 

e Luke Redpath 

e Marcus Zarra 

e Ray Wenderlich 
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